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PREFACE 


The ideal situation occurs when 
the things that we regard as beau- 
tiful are also regarded by other 
people as useful. 

— Donald Knuth 


For us who wrote the following pages, TpX is something beautiful and also useful. We 
enjoy TpX, sharing the delights of newly discovered secrets amongst ourselves and won- 
dering ever a new at the infinite variety of the program and the ingenuity of its creator. 
We also lend a helping hand to the new initiates to this art. Then we thought of extend- 
ing this help to a wider group and The Net being the new medium, we started an online 
tutorial. This was well received and now the Free Software Foundation has decided to 
publish these lessons as a book. It is a fitting gesture that the organization which upholds 
the rights of the user to study and modify a software publish a book on one of the earliest 
programs which allows this right. 

Dear reader, read the book, enjoy it and if possible, try to add to it. 

The TUG India Tutorial Team 
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TUTORIAL I 


THE BASICS 


1. 1. What is ET e X? 

The short and simple answer is that ETeX is a typesetting program and is an extension 
of the original program TgX written by Donald Knuth. But then what is a typesetting 
program ? 

To answer this, let us look at the various stages in the preparation of a document 
using computers. 

1. The text is entered into the computer. 

2. The input text is formatted into lines, paragraphs and pages. 

3 . The output text is displayed on the computer screen. 

4. The final output is printed. 

In most word processors all these operations are integrated into a single application 
package. But a typesetting program like TgX is concerned only with the second stage 
above. So to typeset a document using TgX, we type the text of the document and the 
necessary formatting commands in a text editor (such as Emacs in GNU/Linux) and then 
compile it. After that the document can be viewed using a previeiver or printed using a 
printer driver. 

TgX is also a programming language , so that by learning this language, people can 
write code for additional features. In fact ETeX itself is such a (large) collection of extra 
features. And the collective effort is continuing, with more and more people writing extra 
packages. 

1. 1. 1. A small example 

Let us see LTpX in action by typesetting a short (really short) document. Start your 
favorite text editor and type in the lines below exactly as shown 

\documentcl ass{arti cl e} 

\begi n{document} 

This is my \emph{first} document prepared in \LaTeX. 

\end{document} 

Be especially careful with the \ character (called the backslash) and note that this is 
different from the more familiar / (the slash) in and/or and save the file onto the hard 
disk as myfile.tex. (Instead of myfile you can use any name you wish, but be sure to 
have .tex at the end as the extension.) The process of compiling this and viewing the 
output depends on your operating system. We describe below the process of doing this 
in GNU/Linux. 
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At the shell prompt type 
latex myfile 

You will see a number of lines of text scroll by in the screen and then you get the prompt 
back. To view the output in screen, you must have the X Window running. So, start X if 
you have not done so, and in a terminal window, type 

xdvi myfile 

A window comes up showing the output below 
This is my first document prepared in ETpX. 


Now let us take a closer look at the source file (that is, the file you have typed). 
The first line \documentclass{article} tells IfTpX that what we want to produce is an 
article. If you want to write a book, this must be changed to \documentclass{book}. 
The whole document we want to typeset should be included between \begin{document} 
and \end{document}. In our example, this is just one line. Now compare this line in the 
source and the output. The first three words are produced as typed. Then \emph{fi rst}, 
becomes first in the output (as you have probably noticed, it is a common practice to 
emphasize words in print using italic letters). Thus \emph is a command to ETeX to 
typeset the text within the braces in italic 1 . Again, the next three words come out without 
any change in the output. Finally, the input \LaTeX comes out in the output as ETeX. 

Thus our source is a mixture of text to be typeset and a couple of ETeX commands 
\emph and \LaTeX. The first command changes the input text in a certain way and the 
second one generates new text. Now call up the file again and add one more sentence 
given below. 

This is my \emph{first} document prepared in \LaTeX. I typed it 
on \today. 

What do you get in the output? What new text does the command \today generate? 
I.I.2. Why ETeX? 

So, why all this trouble? Why not simply use a word processor? The answer lies in the 
motivation behind TeX. Donald Knuth says that his aim in creating TeX is to beautifully 
typeset technical documents especially those containing a lot of Mathematics. It is very 
difficult (sometimes even impossible) to produce complex mathematical formulas using a 
word processor. Again, even for ordinary text, if you want your document to look really 
beautiful then ETeX is the natural choice. 

1.2. Simple typesetting 

We have seen that to typeset something in ETeX, we type in the text to be typeset together 
with some ETeX commands. Words must be separated by spaces (does not matter how 
many) and lines maybe broken arbitrarily. 

The end of a paragraph is specified by a blank line in the input. In other words, 
whenever you want to start a new paragraph, just leave a blank line and proceed. For 
example, the first two paragraphs above were produced by the input 
x This is not really true. For the real story of the command, see the section on fonts. 
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We have seen that to typeset something in \LaTeX, we type in the 
text to be typeset together with some \LaTeX\ commands. 

Words must be separated by spaces (does not matter how many) 
and lines maybe broken arbitrarily. 

The end of a paragraph is specified by a \emph{blank line} 
in the input. In other words, whenever you want to start a new 
paragraph, just leave a blank line and proceed. 

Note that the first line of each paragraph starts with an indentation from the left 
margin of the text. If you do not want this indentation, just type \noi ndent at the start 
of each paragraph for example, in the above input, \noi ndent We have seen . . . and 
\noi ndent The end of . . . (come on, try it!) There is an easier way to suppress para- 
graph indentation for all paragraphs of the document in one go, but such tricks can wait. 

1.2. i. Spaces 

You might have noticed that even though the length of the lines of text we type in a 
paragraph are different, in the output, all lines are of equal length, aligned perfectly on 
the right and left. TgX does this by adjusting the space between the words. 

In traditional typesetting, a little extra space is added to periods which end sentences 
and TgX also follows this custom. But how does TgX know whether a period ends a 
sentence or not? It assumes that every period not following an upper case letter ends a 
sentence. But this does not always work, for there are instances where a sentence does 
end in an upper case letter. For example, consider the following 


Carrots are good for your eyes, since they contain Vitamin A. Have you ever seen a rabbit 
wearing glasses? 

The right input to produce this is 

Carrots are good for your eyes, since they contain Vitamin A\@. Have 
you ever seen a rabbit wearing glasses? 

Note the use of the command \@ before the period to produce the extra space after the 
period. (Remove this from the input and see the difference in the output.) 

On the other hand, there are instances where a period following a lowercase letter 
does not end a sentence. For example 


The numbers i, 2, 3, etc. are called natural numbers. According to Kronecker, they were made 
by God; all else being the work of Man. 

To produce this (without extra space after etc. ) the input should be 

The numbers 1, 2, B, etc.\ are called natural numbers. According to 
Kronecker, they were made by Cod;all else being the works of Man. 

Here, we use the command \ (that is, a backslash and a space — here and elsewhere, we 
sometimes use to denote a space in the input, especially when we draw attention to the 
space). 

There are other situations where the command \ (which always produce a space in 
the output) is useful. For example, type the following line and compile it. 


I think \LaTeX is fun. 
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You get 

I think fflgXis fun. 


What happened to the space you typed between \LaTeX and is? You see, TpX gobbles up 
all spaces after a command. To get the required sequence in the output, change the input 
as 

I think \LaTeX\ is fun. 

Again, the command \ comes to the rescue. 

1.2.2. Quotes 

Have you noticed that in typesetting, opening quotes are different from closing quotes? 
Look at the TgX output below 

Note the difference in right and left quotes in ‘single quotes’ and “double quotes”. 

This is produced by the input 

Note the difference in right and left quotes in ‘single quotes’ 
and ‘double quotes’’. 

Modern computer keyboards have a key to type the symbol ' which produces a left quote 
in TeX. (In our simulated inputs, we show this symbol as ‘ . ) Also, the key ’ (the usual 
‘typewriter’ quote key, which also doubles as the apostrophe key) produces a left quote 
in TeX. Double quotes are produced by typing the corresponding single quote twice. The 
‘usual’ double quote key " can also be used to produce a closing double quote in TeX. 

If your keyboard does not have a left quote key, you can use \1 q command to produce 
it. The corresponding command \rq produces a right quote. Thus the output above can 
also be produced by 

Note the difference in right and left quotes in \lq single 
quotes\rq\ and \lq\lq double quotes\rq\rq . 

(Why the command \ after the first \rq?) 

1.2.3. Dashes 

In text, dashes are used for various purposes and they are distinguished in typesetting by 
their lengths; thus short dashes are used for hyphens, slightly longer dashes are used to 
indicate number ranges and still longer dashes used for parenthetical comments. Look at 
the following TeX output 

X-rays are discussed in pages 221-225 of Volume 3 — the volume on electromagnetic waves. 
This is produced from the input 

X-rays are discussed in pages 221--225 of Volume 3 — the volume on 
electromagnetic waves. 

Note that a single dash character in the input - produces a hyphen in the output, two 
dashes -- produces a longer dash (-) in the output and three dashes — produce the 
longest dash ( — ) in the output. 
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1.2.4. Accents 

Sometimes, especially when typing foreign words in English, we need to put different 
types of accents over the letters. The table below shows the accents available in ETeX. 
Each column shows some of the accents and the inputs to generate them. 


6 \‘o 

6 \’o 

6 \"o 

6 \~o 

6 \=o 

6 \.o 

0 \"o 

/ 

n 

n 

6 \u 0 

0 \b 0 

6 \v 0 

do \t 00 

0 \H 0 

0 \d 0 


The letters i and j need special treatment with regard to accents, since they should not 
have their customary dots when accented. The commands \i and \j produce dot-less i 
and j as 1 and j. Thus to get 

El esta aqui 

you must type 
V {E}1 est\’ fa} aqu\ ’ {\i } 

Some symbols from non-English languages are also available in ETeX, as shown in 
the table below: 


oe 

\oe 

(E 

\0E 

se \ae 

M 

\AE 


\aa 


\AA 




0 

\o 

0 

\o 

1 \1 

l 

\L 

6 

i 

\ss 

J ‘ 

t 

? ‘ 





1.2.5. Special symbols 

We have see that the input \LaTeX produces ETeX in the output and \ produces a space. 
Thus TeX uses the symbol \ for a special purpose — to indicate the program that what 
follows is not text to be typeset but an instruction to be carried out. So what if you 
want to get \ in your output (improbable as it may be)? The command \textbacksl ash 
produces \ in the output. 

Thus \ is a symbol which has a special meaning for TeX and cannot be produced by 
direct input. As another example of such a special symbol, see what is obtained from the 
input below 

Maybe I have now learnt about 1% of \LaTeX. 

You only get 

Maybe I have now learnt about 1 

What happened to the rest of the line? You see, TeX uses the per cent symbol % as the 
comment character; that is a symbol which tells TeX to consider the text following as 
‘comments’ and not as text to be typeset. This is especially useful for a TeX programmer 
to explain a particularly sticky bit of code to others (and perhaps to himself). Even for 
ordinary users, this comes in handy, to keep a ‘to do’ list within the document itself for 
example. 

But then, how do you get a percent sign in the output? Just type \% as in 
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Maybe I have now learnt about 1\% of \LaTeX. 

The symbols \ and % are just two of the ten charcaters TgX reserves for its internal 
use. The complete list is 
' # $ % * & _ \ { } 

We have seen how TgX uses two of these symbols (or is it four? Did not we use { } in 
one of our examples?) The use of others we will see as we proceed. 

Also, we have noted that \ is produced in the output by the command \textbacksl ash 
and % is produced by \%. What about the other symbols? The table below gives the inputs 
to produce these symbols. 


~ 

\textascii tilde 

& 

\& 

# 

\# 

_ 

\_ 

$ 

\$ 

\ 

\textbacksl ash 

% 

\% 

{ 

\{ 


\textasci i ci rcum 

I 

\} 


You can see that except for three, all special symbols are produced by preceding them 
with a \. Of the exceptional three, we have seen that V and V are used for producing 
accents. So what does \\ do? It is used to break lines. For example, 

This is the first line.\\ This is the second line 

produces 

This is the first line. 

This is the second line 

We can also give an optional argument to \\ to increase the vertical distance between the 
lines. For example, 

This is the first 1 i ne.\\[10pt] 

This is the second line 
gives 

This is the first line. 

This is the second line 

Now there is an extra io points of space between the lines (i point is about i/72 nd of an 
inch). 

1.2.6. Text positioning 

We have seen that TgX aligns text in its own way, regardless of the way text is formatted 
in the input file. Now suppose you want to typeset something like this 


The TpXnical Institute 
Certificate 

This is to certify that Mr. N. O. Vice has undergone a course at this institute 
and is qualified to be a TpXnician. 

The Director 
The TpXnical Institute 


This is produced by 


i-3- Fonts 


*3 


\begi n{center} 

The \TeX nical Institute\\[.75cm] 

Certi fi cate 
\end{center} 

\noindent This is to certify that Mr. N. 0. Vice has undergone a 
course at this institute and is qualified to be a \TeX nician. 

\begi n{fl ushri ght} 

The Di recto r\\ 

The \TeX nical Institute 
\end{fl ushri ght} 

Here, the commands 

\begi nfcenter} ... \end{center} 

typesets the text between them exactly at the center of the page and the commands 
\begi n{fl ushright} ... \end{flushright} 

typesets text flush with the right margin. The corresponding commands 
\begi n{fl ushleft} ... \end{fl ushl eft} 

places the enclosed text flush with the left margin. (Change the fl ushright to fl ushl eft 
and see what happens to the output.) 

These examples are an illustration of a ETeX construct called an environment, which 
is of the form 

\begin {name} ... \end{«<j«ze} 

where name is the name of the environment. We have seen an example of an environment 
at the very beginning of this chapter (though not identified as such), namely the document 
environment. 


1.3. Fonts 

The actual letters and symbols (collectively called type) that hTpX (or any other typeset- 
ting system) produces are characterized by their style and size. For example, in this book 
emphasized text is given in italic style and the example inputs are given in typewriter 

style. We can also produce smaller and bigger type. A set of types of a particular style 
and size is called a font. 

1.3.1. Type style 

In FTeX, a type style is specified by family, series and shape. They are shown in the table 

1. 1. 

Any type style in the output is a combination of these three characteristics. For exam- 
ple, by default we get roman family, medium series, upright shape type style in a ETeX 
output. The \texti t command produces roman family, medium series, italic shape type. 
Again, the command \textbf produces roman family, boldface series, upright shape type. 

We can combine these commands to produce a wide variety of type styles. For exam- 
ple, the input 

\textsf{\textbf {sans serif family, boldface series, upright shape}} 
\textrm{\textsl {roman family, medium series, slanted shape}} 
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Table I.i: 



STYLE 

Command 


roman 

\textrm{roman} 

3 

c 

sans serif 

\textsf{sans serif} 

Ph 

typewri ter 

\texttt{typewri ter} 

co 

Uj 

medium 

\textmd{medi urn} 

oS 

W 

co 

boldface 

\textbf {bol dface} 


upright 

\textup{upri ght} 

BJ 

Oh 

< 

italic 

\texti t{i tal i c} 

X 

co 

slanted 

\textsl {slanted} 


SMALL CAP 

\textsc{small cap} 


produces the output shown below: 

sans serif family, boldface series, upright shape 

roman family, medium series, slanted shape 


Some of these type styles may not be available in your computer. In that case, FT^X 
gives a warning message on compilation and substitutes another available type style 
which it thinks is a close approximation to what you had requested. 

We can now tell the whole story of the \emph command. We have seen that it usually, 
that is when we are in the middle of normal (upright) text, it produces italic shape. But if 
the current type shape is slanted or italic, then it switches to upright shape. Also, it uses 
the family and series of the current font. Thus 

\textit{A polygon of three sides is called a \emph{tri angl e} and a 
polygon of four sides is called a \emph{quadri 1 ateral }} 

gives 

A polygon of three sides is called a triangle and a polygon of four sides is called a quadrilateral 
while the input 

\textbf{A polygon of three sides is called a 
\emph{tri angl e} and a polygon of four sides is called a 
\emph{quadri 1 ateral }} 

produces 

A polygon of three sides is called a triangle and a polygon of four sides is called a quadrilateral 


Each of these type style changing commands has an alternate form as a declaration. 
For example, instead of \textbf {boldface} you can also type {\bfseries boldface} to 
get boldface. Note that that not only the name of the command, but its usage also is 
different. For example, to typeset 
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By a triangle, we mean a polygon of three sides. 


if you type 

By a \bfseries{tri angle} , we mean a polygon of three sides, 
you will end up with 


By a triangle, we mean a polygon of three sides. 


Thus to make the declaration act upon a specific piece of text (and no more), the decla- 
ration and the text should be enclosed in braces. 

The table below completes the one given earlier, by giving also the declarations to 
produce type style changes. 



STYLE 

Command 

Declaration 

SHAPE 

upright 
italic 
slanted 
SMALL CAP 

\textup{upright} 
\texti t{i tal i c} 
\textsl {si anted} 
\textsc{smal 1 cap} 

{\upshape upright} 
{\itshape italic} 
{\slshape slanted} 
{\scshape small cap} 

SERIES 

medium 

boldface 

\textmd{medi um} 
\textbf {bol dface} 

{\mdseries medium} 
{\bfseries boldface} 

FAMILY 

roman 
sans serif 
typewriter 

\textrm{ roman} 
\textsf{sans serif} 
\texttt{typewri ter} 

{\rmfamily roman} 
{\sffamily sans serif} 
{\ttfamily typewriter} 


These declaration names can also be used as environment names. Thus to type- 
set a long passage in, say, sans serif, just enclose the passage within the commands 
\begi nfsffmi ly} ... \end{sffamily}. 

1.4. Type size 

Traditionally, type size is measured in (printer) points. The default type that TgX pro- 
duces is of 10 pt size. There are some declarations (ten, to be precise) provided in UTeX 
for changing the type size. They are given in the following table: 


size 

{\tiny size} 

size 

{\large size} 

size 

{\scriptsize size} 

size 

{\Large size} 

size 

{\footnotesi ze size} 

size 

{\LARGE size} 

size 

{\small size} 

size 

{\huge size} 

size 

{\normalsize size} 

size 

{\Huge size} 


Note that the \normalsize corresponds to the size we get by default and the sizes form 
an ordered sequence with \ti ny producing the smallest and \Huge producing the largest. 
Unlike the style changing commands, there are no command-with -one-argument forms 
for these declarations. 

We can combine style changes with size changes. For example, the “certificate” we 
typed earlier can now be ‘improved’ as follows 
\begi nfcenter} 

{\bfseries\huge The \TeX nical Institute}\\[lcm] 

{\scshape\LARGE Certificate} 
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\end{center} 

\noindent This is to certify that Mr. N. 0. Vice has undergone a 
course at this institute and is qualified to be a \TeX nical Expert. 

\begi n{fl ushri ght} 

{\sffamily The Director\\ 

The \TeX nical Institute} 

\end{fl ushri ght} 

and this produces 

The T£Xnical Institute 

Certificate 

This is to certify that Mr. N. O. Vice has undergone a course at this institute and is 
qualified to be a TpXnical Expert. 

The Director 
The TgXnical Institute 
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THE DOCUMENT 


ii. i. Document class 

We now describe how an entire document with chapters and sections and other embellish- 
ments can be produced with ETeX. We have seen that all ETeX files should begin by spec- 
ifying the kind of document to be produced, using the command \documentcl ass{ ... }. 
We’ve also noted that for a short article (which can actually turn out to be quite long!) we 
write \documentclass{article} and for books, we write \documentcl ass{book}. There 
are other document classes available in ETeX such as report and letter. All of them 
share some common features and there are features specific to each. 

In addition to specifying the type of document (which we must do, since ETeX has 
no default document class), we can also specify some options which modify the default 
format. Thus the actual syntax of the \documentclass command is 
\documentcl ass [ options ] {class} 

Note that options are given in square brackets and not braces. (This is often the 
case with ETeX commands — options are specified within square brackets, after which 
mandatory arguments are given within braces.) 

11.1.1. Font size 

We can select the size of the font for the normal text in the entire document with one of 
the options 

lOpt llpt 12 pt 
Thus we can say 

\documentcl ass [llpt] {arti cl e} 

to set the normal text in our document in n pt size. The default is lOpt and so this is the 
size we get, if we do not specify any font-size option. 

11. 1. 2. Paper size 

We know that ETeX has its own method of breaking lines to make paragraphs. It also has 
methods to make vertical breaks to produce different pages of output. For these breaks 
to work properly, it must know the width and height of the paper used. The various 
options for selecting the paper size are given below: 


1 etterpaper 

11X8.5 i n 

a 4 paper 

20.7X21 in 

legalpaper 

14X8.5 in 

a 5 paper 

21X14.8 in 

executivepaper 

10.5X7.25 in 

b 5 paper 

25X17.6 in 


Normally, the longer dimension is the vertical one — that is, the height of the page. The 
default is letterpaper. 
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II. i. 3. Page formats 

There are options for setting the contents of each page in a single column (as is usual) or 
in two columns (as in most dictionaries). This is set by the options 

onecolumn twocolumn 
and the default is onecolumn. 

There is also an option to specify whether the document will be finally printed on just 
one side of each paper or on both sides. The names of the options are 

oneside twoside 

One of the differences is that with the twoside option, page numbers are printed on 
the right on odd-numbered pages and on the left on even numbered pages, so that when 
these printed back to back, the numbers are always on the outside, for better visibility. 
(Note that DTpX has no control over the actual printing. It only makes the formats for 
different types of printing.) The default is oneside for article, report and letter and 
twosi de for book. 

In the report and book class there is a provision to specify the different chapters (we 
will soon see how). Chapters always begin on a new page, leaving blank space in the 
previous page, if necessary. With the book class there is the additional restriction that 
chapters begin only on odd-numbered pages, leaving an entire page blank, if need be. 
Such behavior is controlled by the options, 

openany openright 

The default is openany for reportclass (so that chapters begin on “any” new page) 
and openright for the book class (so that chapters begin only on new right, that is, odd 
numbered, page). 

There is also a provision in I'TpX for formatting the “title” (the name of the docu- 
ment, author(s) and so on) of a document with special typographic consideration. In the 
article class, this part of the document is printed along with the text following on the 
first page, while for report and book, a separate title page is printed. These are set by the 
options 

notitlepage titlepage 

As noted above, the default is notitlepage for article and titlepage for report and 
book. As with the other options, the default behavior can be overruled by explicitly 
specifying an option with the documentclass command. 

There are some other options to the documentcl ass which we will discuss in the rele- 
vant context. 


11. 2. Page style 

Having decided on the overall appearance of the document through the \documentclass 
command with its various options, we next see how we can set the style for the individual 
pages. In TTeX parlance, each page has a “head” and “foot” usually containing such 
information as the current page number or the current chapter or section. Just what goes 
where is set by the command 

\pagestyl e{ . . .} 

where the mandatory argument can be any one of the following styles 
plain empty headings myheadings 
The behavior pertaining to each of these is given below: 
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plain The page head is empty and the foot contains just the page number, cen- 
tered with respect to the width of the text. This is the default for the 
article class if no \pagestyle is specified in the preamble. 

empty Both the head and foot are empty. In particular, no page numbers are 
printed. 

headings This is the default for the book class. The foot is empty and the head 
contains the page number and names of the chapter section or subsection, 
depending on the document class and its options as given below: 


CLASS 

OPTION 

LEFT PAGE 

RIGHT PAGE 

book, report 

one-sided 

— 

chapter 

two-sided 

chapter 

section 

arti cle 

one-sided 

— 

section 

two-sided 

section 

subsection 


myheadings The same as headings, except that the ‘section’ information in the head 
are not predetermined, but to be given explicitly using the commands 
\markright or \markboth as described below. 


Moreover, we can customize the style for the current page only using the command 
\thi spagestyl e{style} 

where style is the name of one of the styles above. For example, the page number may 
be suppressed for the current page alone by the command \thi spagestyl e{empty}. Note 
that only the printing of the page number is suppressed. The next page will be numbered 
with the next number and so on. 


II.2.1. Heading declarations 

As we mentioned above, in the page style myheadings, we have to specify the text to 
appear on the head of every page. It is done with one of the commands 

\markboth{/e/t head{right bead } 

\markri ght{rigbt bead } 

where left bead is the text to appear in the head on left-hand pages and right head is the 
text to appear on the right-hand pages. 

The \markboth command is used with the twoside option with even numbered pages 
considered to be on the left and odd numbered pages on the right. With oneside option, 
all pages are considered to be right-handed and so in this case, the command \markright 
can be used. These commands can also be used to override the default head set by the 
headi ngs style. 

Note that these give only a limited control over the head and foot, since the general 
format, including the font used and the placement of the page number, is fixed by PTeX. 
Better customization of the head and foot are offered by the package fancyhdr, which is 
included in most PTeX distributions. 


II. 3. PAGE NUMBERING 

The style of page numbers can be specified by the command 
\pagenumberi ng{ . . .} 

The possible arguments to this command and the resulting style of the numbers are given 
below: 


20 


ii. The Document 


arabic Indo-Arabic numerals 
roman lowercase Roman numerals 
Roman upper case Roman numerals 
al ph lowercase English letters 

A1 ph uppercase English letters 

The default value is arabi c. This command resets the page counter. Thus for example, to 
number all the pages in the ‘Preface’ with lowercase Roman numerals and the rest of the 
document with Indo-Arabic numerals, declare \pagenumbering{roman} at the beginning 
of the Preface and issue the command \pagestyle{arabic} immediately after the first 
\chapter command. (The \chapter{. . .} command starts a new chapter. We will come 
to it soon.) 

We can make the pages start with any number we want by the command 
\setcounter{page}{««»jher} 

where number is the page number we wish the current page to have. 

ii. 4. Formatting lengths 

Each page that ETeX produces consists not only of a bead and foot as discussed above 
but also a body (surprise!) containing the actual text. In formatting a page, ETeX uses 
the width and heights of these parts of the page and various other lengths such as the 
left and right margins. The values of these lengths are set by the paper size options and 
the page format and style commands. For example, the page layout with values of these 
lengths for an odd page and even in this book are separately shown below. 

These lengths can all be changed with the command \setlength. For example, 

\setl ength{\textwi dth}{15cm} 

makes the width of text 15 cm. The package geometry gives easier interfaces to customize 
page format. 


11. 5. Parts of a document 

We now turn our attention to the contents of the document itself. Documents (especially 
longer ones) are divided into chapters, sections and so on. There may be a title part 
(sometimes even a separate title page) and an abstract. All these require special typo- 
graphic considerations and ETeX has a number of features which automate this task. 

II. 5. 1. Title 

The “title” part of a document usually consists of the name of the document, the name 
of author) s) and sometimes a date. To produce a title, we make use of the commands 
\ti tl e{document name } 

\autho r {author names} 

\dat e{date text } 

\maketitle 

Note that after specifying the arguments of \title, \author and \date, we must issue the 
command \maketitle for this part to be typeset. 

By default, all entries produced by these commands are centered on the lines in which 
they appear. If a title text is too long to fit in one line, it will be broken automatically. 
However, we can choose the break points with the \\ command. 

If there are several authors and their names are separated by the \and command, then 
the names appear side by side. Thus 
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\ti tl e{Ti tl e} 

\author{Author 1\\ 

Address line 11\\ 

Address line 12\\ 

Address line 13 
\and 

Author 2\\ 

Address line 21\\ 

Address line 22\\ 

Address line 23} 

\date{Month Date, Year} 

produces 

Title 


Author i 
Address line 1 1 
Address line 12 
Address line 13 


Author 2 
Address line 21 
Address line 22 
Address line 23 


Month Date, Year 

If instead of \and, we use (plain old) \\, the names are printed one below another. 

We may leave some of these arguments empty; for example, the command \date{ } 
prints no date. Note, however, that if you simply omit the \date command itself, the 
current date will be printed. The command 

\thanks{/bof«ofe text} 

can be given at any point within the \title, \author or \date. It puts a marker at this 
point and places the footnote text as a footnote. (The general method of producing a 
footnote is to type \footnot e{footnote text } at the point we want to refer to.) 

As mentioned earlier, the “title” is printed in a separate page for the document classes 
book and report and in the first page of the document for the class article. (Also recall 
that this behavior can be modified by the options titlepage or notitlepage.) 

II. 5. 2. Abstract 

In the document classes article and report, an abstract of the document in special for- 
mat can be produced by the commands 

\begi n{abstract} Abstract Text 

\end{abstract} 

Note that we have to type the abstract ourselves. (There is a limit to what even UTpX can 
do.) In the report class this appears on the separate title page and in the article class it 
appears below the title information on the first page (unless overridden by the title page 
option). This command is not available in the book class. 

11. 6. Dividing the document 

A book is usually divided into chapters and (if it is technical one), chapters are divided 
into sections, sections into subsections and so on. DT£X provides the following hierarchy 
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of sectioning commands in the book and report class: 

\chapter 

\section 

\subsection 

\subsubsection 

\paragraph 

\subparagraph 

Except for \chapter all these are available in article class also. For example, the 
heading at the beginning of this chapter was produced by 

\chapter{The Document} 
and the heading of this section was produced by 
\section{Dividing the document} 

To see the other commands in action, suppose at this point of text I type 
\subsection{Exampl e} 

In this example, we show how subsections and subsubsections 
are produced (there are no subsubsubsections). Note how the 
subsections are numbered. 

\subsubsecti on{Subexampl e} 

Did you note that subsubsections are not numbered? This is so in the 
\texttt{book} and \texttt{report} classes. In the \texttt{arti cl e} 
class they too have numbers. (Can you figure out why?) 

\paragraph{Note} 

Paragraphs and subparagraphs do not have numbers. And they have 
\textit{run-in} headings. 

Though named ‘‘paragraph’’ we can have several paragraphs of text 
within this. 

\subparagraph {Subnote} 

Subparagraphs have an additional indentation too. 

And they can also contain more than one paragraph of text. 

We get 

II.6.1. Example 

In this example, we show how subsections and subsubsections are produced (there are 
no subsubsubsections). Note how the subsections are numbered. 

Subexample 

Did you note that subsubsections are not numbered? This is so in the book and report 
classes. In the article class they too have numbers. (Can you figure out why?) 

Note Paragraphs and subparagraphs do not have numbers. And they have run-in head- 
ings. Though named “paragraph” we can have several paragraphs of text within this. 

Subnote Subparagraphs have an additional indentation too. And they can also con- 
tain more than one paragraph of text. 


ii. 7- What next? 
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II.6.2. More on sectioning commands 

In the book and the report classes, the \chapter command shifts to the beginning of a 
new page and prints the word “Chapter” and a number and beneath it, the name we have 
given in the argument of the command. The \section command produces two numbers 
(separated by a dot) indicating the chapter number and the section number followed 
by the name we have given. It does not produce any text like “Section”. Subsections 
have three numbers indicating the chapter, section and subsection. Subsubsections and 
commands below it in the hierarchy do not have any numbers. 

In the article class, \section is highest in the hierarchy and produces single number 
like \chapter in book. (It does not produce any text like “Section”, though.) In this case, 
subsubsections also have numbers, but none below have numbers. 

Each sectioning command also has a “starred” version which does not produce num- 
bers. Thus \s&ct\ on* {name} has the same effect as \section {name}, but produces no 
number for this section. 

Some books and longish documents are divided into parts also. ETeX also has a \part 
command for such documents. In such cases, \part is the highest in the hierarchy, but it 
does not affect the numbering of the lesser sectioning commands. 

You may have noted that ETeX has a specific format for typesetting the section head- 
ings, such as the font used, the positioning, the vertical space before and after the heading 
and so on. All these can be customized, but it requires some TEXpertise and cannot be 
addressed at this point. However, the package sectsty provided some easy interfaces for 
tweaking some of these settings. 


11. 7. What next? 

The task of learning to create a document in ETeX is far from over. There are other 
things to do such as producing a bibliography and a method to refer to it and also at the 
end of it all to produce a table of contents and perhaps an index. All these can be done 
efficiently (and painlessly) in ETeX, but they are matters for other chapters. 


1 

one inch + \hoffset 

2 

one inch + \voffset 

B 

\evensi demargi n = 54pt 

4 

\topmargin = 18pt 

5 

\headheight = 12pt 

6 

\headsep = 18pt 

7 

\textheight = 609pt 

8 

\textwidth = 380pt 

9 

\margi nparsep = 7pt 

10 

\marginparwidth = 115pt 

11 

\footskip = 25pt 
\hoffset = Opt 
\paperwidth = 597pt 


\margi nparpush = 5pt (not shown) 
\voffset = Opt 
\paperheight = 845pt 





1 

one inch + \hoffset 

2 

one inch + \voffset 

B 

\oddsi demargi n = 18pt 

4 

\topmargin = 18pt 

5 

\headheight = 12pt 

6 

\headsep = 18pt 

7 

\textheight = 609pt 

8 

\textwidth = 380pt 

9 

\margi nparsep = 7pt 

10 

\marginparwidth = 115pt 

11 

\footskip = 25pt 
\hoffset = Opt 
\paperwidth = 597pt 


\margi nparpush = 5pt (not shown) 
\voffset = Opt 
\paperheight = 845pt 





2 6 



TUTORIAL III 


BIBLIOGRAPHY 


hi. i. Introduction 

Bibliography is the environment which helps the author to cross-reference one publica- 
tion from the list of sources at the end of the document. DTpX helps authors to write a 
well structured bibliography, because this is how ETeX works — by specifying structure. 

It is easy to convert the style of bibliography to that of a publisher’s requirement, 
without touching the code inside the bibliography. We can maintain a bibliographic data 
base using the program BibTeX. While preparing the articles, we can extract the needed 
references in the required style from this data base, harvard and natbib are widely used 
packages for generating bibliography. 

To produce bibliography, we have the environment thebibliography 1 , which is sim- 
ilar to the enumerate environment. Here we use the command \bibitem to separate the 
entries in the bibliography and use \ci te to refer to a specific entry from this list in the 
document. This means that at the place of citation, it will produce number or author-year 
code connected with the list of references at the end. 

\begi n{thebi bl i ography} {widest-label} 

\bibitem {keyl} 

\bi bi tem{key2} 

\end{thebi bl i ography} 

The \begi n{thebi bl i ography} command requires an argument that indicates the 
width of the widest label in the bibliography. If you know you would have between 
io and 99 citations, you should start with 

\begi n{thebi bl i ography} {99} 

You can use any two digit number in the argument, since all numerals are of the same 
width. If you are using customized labels, put the longest label in argument, for example 
\begi n{thebi bl iography}{Long-name}. Each entry in the environment should start with 

\bibitem{&eyl} 

If the author name is Alex and year 1991, the key can be coded as ale9i or some 
such mnemonic string 1 . This key is used to cite the publication within the document text. 
To cite a publication from the bibliography in the text, use the \cite command, which 
takes with the corresponding key as the argument. However, the argument to \ci te can 
also be two or more keys, separated by commas. 

z Bibiliography environment need two compilations. In the first compilation it will generate file with aux 
extension, where ci tati on and bi bci te will be marked and in the second compilation \ci te will be replaced 
by numeral or author-year code. 

2 Key can be any sequence of letters, digits and punctuation characters, except that it may not contain a 
comma (maximum 256 characters). 
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\cit e{keyl} \cite{keyl,key2} 

In bibliography, numbering of the entries is generated automatically. You may also add 
a note to your citation, such as page number, chapter number etc. by using an optional 
argument to the \ci te command. Whatever text appears in this argument will be placed 
within square brackets, after the label. 

\ci te [page" 2 5] { keyl } 

See below an example of bibliography and citation. The following code 

It is hard to write unstructured and disorganised documents using 
\LaTeX"\ci te{les85} . It is interesting to typeset one 
equation"\cite[Sec 3.3]{les85} rather than setting ten pages of 
running matter"\cite{don89, rondon89}. 

\begi n{thebi bi i ography}{9} 

\bi bi tem{l es85}Lesl i e Lamport, 1985. \emph{\LaTeX — A Document 
Preparation System — User’s Guide and Reference Manual}, 

Addision-Wesley, Reading. 

\bi bi tem{don89}Donald E. Knuth, 1989. \emph{Typesetti ng Concrete 
Mathematics}, TUGBoat, 10(l):31-36. 

\bibitem{rondon89}Ronald L. Graham, Donald E. Knuth, and Ore 
Patashnik, 1989. \emph{Concrete Mathematics: A Foundation for 
Computer Science}, Addison-Wesley, Reading. 

\end{thebi bl i ography} 

produces the following output: 


It is hard to write unstructured and disorganised documents using ETgX [ij. It is interesting to 
typeset one equation [i, Sec 3.3] rather than setting ten pages of running matter [2,3]. 

Bibliography 

[1] Leslie Lamport, 1985. iffgX — A Document Preparation System — User’s Guide and Refer- 
ence Manual, Addision-Wesley, Reading. 

[2] Donald E. Knuth, 1989. Typesetting Concrete Mathematics, TUGBoat, io(i):3i-36. 

[3] Ronald L. Graham, Donald E. Knuth, and Ore Patashnik, 1989. Concrete Mathematics: 
A Foundation for Computer Science, Addison-Wesley, Reading. 


III. 2. NATBIB 

The natbib package is widely used for generating bibliography, because of its flexible 
interface for most of the available bibliographic styles. The natbib package is a re- 
implementation of the TTgX \cite command, to work with both author-year and nu- 
merical citations. It is compatible with the standard bibliographic style files, such as 
plain. bst, as well as with those for harvard, apalike, Chicago, astron, authordate, and 
of course natbib. To load the package; use the command. 

\usepackage [opti ons] {natbi b} 


III. 2. NATBIB 
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III. 2. 1. Options for natbib 

round 

(default) for round parentheses 

square 

for square brackets 

curl y 

for curly braces 

angl e 

for angle brackets 

colon 

(default) to separate multiple citations with colons 

comma 

to use commas as separators 

authoryear 

(default) for author-year citations 

numbers 

for numerical citations 

super 

for superscripted numerical citations, as in Nature 

sort 

orders multiple citations into the sequence in which they 
appear in the list of references 

sort&compress 

as sort but in addition multiple numerical citations are 
compressed if possible (as 3-6, 15) 

longnamesfi rst 

makes the first citation of any reference the equivalent 
of the starred variant (full author list) and subsequent 
citations normal (abbreviated list) 

secti onbi b 

redefines \thebibli ography to issue \section* instead of 
\chapter*; valid only for classes with a \chapter com- 
mand; to be used with the chapterbib package 

nonamebreak 

keeps all the authors’ names in a citation on one line; 
causes overfull hboxes but helps with some hyperref 
problems. 


You can set references in the Nature style of citations (superscripts) as follows 
\documentcl ass{arti cl e} 

\usepackage{natbi b} 

\ci testyl e{nature} 

\begi n{document} 


\end{document} 

III. 2. 2. Basic commands 

The natbib package has two basic citation commands, \citet and \citep for textual 
and parenthetical citations, respectively. There also exist the starred versions \citet* 
and \ci tep* that print the full author list, and not just the abbreviated one. All of these 
may take one or two optional arguments to add some text before and after the citation. 
Normally we use author name and year for labeling the bibliography. 

\begi n{thebi bl i ography}{wi dest-1 abel } 

\bibitem{Leslie(1985)}{les85}Les'lie Lamport, 1985. 

\emph{\LaTeX — A Document Preparation}... 
\bibitem{Donale(00)}{don89}Donald E. Knuth, 1989. 

\emph{Typesetti ng Concrete Mathematics},... 

\bi bi tem{Ronald , Donald and 0re(1989)}{rondon89}Ronald L. Graham, ... 
\end{thebi bl i ography} 

Year in parentheses is mandatory in optional argument for bibitem. If year is missing 
in any of the bibitem, the whole author-year citation will be changed to numerical cita- 
tion. To avoid this, give ‘(0000)’ for year in optional argument and use partial citations 
(\ci teauthor) in text. 
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Don’t put ‘space character’ before opening bracket of year in optional argument. 


\ci tet{al e91} => 

\ci tet [chap. ~4] {al e91} => 

\ci tep{al e91} => 

\ci tep[chap. ~4] {al e91} => 

\citep[see] []{ale91} => 

\ci tep[see] [chap. "4] { jon91} => 
\ci tet*{al e91} => 

\ci tep*{al e91} => 


Alex et al. (1991) 

Alex et al. (1991, chap. 4) 

(Alex et al., 1991) 

(Alex et al., 1991, chap. 4) 

(see Alex et al., 1991) 

(see Alex et al., 1991, chap. 4) 
Alex, Mathew, and Ravi (1991) 
(Alex, Mathew, and Ravi, 1991) 


III. 2. 3. Multiple citations 

Multiple citations may be made as usual, by including more than one citation key in the 
\ci te command argument. 


\ci tet{al e91, rav92} => Alex et al. (1991); Ravi et al. (1992) 

\ci tep{al e91, rav92} => (Alex et al., 1991; Ravi et al. 1992) 

\ci tep{al e91, al e92} => (Alex et al., 1991, 1992) 

\citep{ale91a,ale91b} => (Alex et al., 1991a, b) 


III. 2. 4. Numerical mode 


These examples are for author-year citation mode. In numerical mode, the results are 
different. 


\citet{ale91} 


Alex et al. [5] 

\ci tet [chap. ’4] {al e91} 

=> 

Alex et al. [5, chap. 4] 

\citep{ale91} 

=> 

[ 5 ] 

\ci tep [chap. ’4] {al e91} 

=> 

[5, chap. 4J 

\citep[see] []{ale91} 

=> 

[see 5J 

\ci tep [see] [chap. ”4] {al e91} 

=> 

[see 5, chap. 4] 

\ci tep{al e91a, al e91b} 


[5, 12-] 


III. 2. 5. Suppressed parentheses 


As an alternative form of citation, \ci teal t is the same as \ci tet but without any paren- 
theses. Similarly, \ci teal p is \ci tep with the parentheses turned off. Multiple references, 
notes, and the starred variants also exist. 


\ci tealtfal e91} => 

\ci tealt*{al e91} => 

\ci teal p{al e91} => 

\ci teal p*{al e91} => 


\ci teal p{al e91, al e92} => 

\ci teal p[pg . "7] {al e91} => 

\ci tetext{short comm.} => 


Alex et al. 1991 

Alex, Mathew, and Ravi 1991 

Alex., 1991 

Alex, Mathew, and Ravi, 1991 
Alex et al., 1991; Alex et ah, 1992 
Alex., 1991, pg. 7 
(short comm.) 


The \citetext command allows arbitrary text to be placed in the current citation paren- 
theses. This may be used in combination with \citealp. 
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111.2.6. Partial citations 

In author-year schemes, it is sometimes desirable to be able to refer to the authors with- 
out the year, or vice versa. This is provided with the extra commands 


\ci teauthor{al e91} => Alex et al. 

\citeauthor*{ale91} => Alex, Mathew, and Ravi 
\ci teyear{al e91} => 1991 

\ci teyearparjal e91} => ( 1991 ) 


III. 2. 7. Citations aliasing 

Sometimes one wants to refer to a reference with a special designation, rather than by the 
authors, i.e. as Paper I, Paper II. Such aliases can be defined and used, textually and/or 
parenthetically with: 

\defci teal i as{ jon90}{ Paper"!} 


\citetalias{ale91} => Paper I 
\citepalias{ale91} => (Paper I) 

These citation commands function much like \ci tet and \ci tep: they may take multiple 
keys in the argument, may contain notes, and are marked as hyperlinks. 

III. 2 . 8 . Selecting citation style and punctuation 

Use the command \bi bpunct with one optional and six mandatory arguments: 

1. The opening bracket symbol, default = ( 

2 . The closing bracket symbol, default = ) 

3. The punctuation between multiple citations, default = ; 

4. The letter ‘n’ for numerical style, or ‘s’ for numerical superscript style, any other letter 
for author-year, defaul t = author--year; 

5. The punctuation that comes between the author names and the year 

6. The punctuation that comes between years or numbers when common author lists are 
suppressed (default = ,); 

The optional argument is the character preceding a post-note, default is a comma 
plus space. In redefining this character, one must include a space if that is what one 
wants. 

Example 1 

\bi bpunct { [}{]}{, }{a}{}{;} 
changes the output of 

\ci tep{ jon90, jon91, jam92} 
into 

[Jones et al. 1990; 1991, James et al. 1992]. 
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Example 2 

\bibpunct[ ;]{(}{)}{, }{a}{}{;} 
changes the output of 

\citep[and references therei n] { jon90} 
into 

(Jones et al. 1990; and references therein). 


TUTORIAL IV 


BIBLIOGRAPHIC DATABASES 


Bibliographic database is a database in which all the useful bibliographic entries can be 
stored. The information about the various publications is stored in one or more files with 
the extension . bi b. For each publication, there is a key that identifies it and which may 
be used in the text document to refer to it. And this is available for all documents with 
a list of reference in the field. This database is useful for the authors/researchers who 
are constantly referring to the same publications in most of their works. This database 
system is possible with the BlBTgX program supplied with the LTpX package. 

iv. i. The BrnTgX program 

BlBTgX is an auxiliary program to LTpX that automatically constructs a bibliography for 
a BTeX document from one or more databases. To use BibTeX, you must include in your 
UTeX input file a \bibliography command whose argument specifies one or more files 
that contain the database. For example 

\bi bl i ography {databasel ,database2} 

The above command specifies that the bibliographic entries are obtained from databasel. bib 
and database2.bib. To use BibTeX, your ETeX input file must contain a \bi bl i ographystyl e 
command. This command specifies the bibliography style, which determines the format 
of the source list. For example, the command 

\bi bl i ographystyl e{plai n} 

specifies that entries should be formatted as specified by the plain bibliography style 
(plain. bst). We can put \bibliographystyle command anywhere in the document after 
the \begi n{document} command. 

iv. 2. BiBTgX style files 

plain Standard BibTeX style. Entries sorted alphabetically with numeric labels. 

unsrt Standard BibTeX style. Similar to plain, but entries are printed in order of 
citation, rather than sorted. Numeric labels are used. 

alpha Standard BibTeX style. Similar to plain, but the labels of the entries are formed 
from the author’s name and the year of publication. 

abbrv Standard BibTeX style. Similar to plain, but entries are more compact, since 
first names, month, and journal names are abbreviated. 

acm Alternative BibTeX style, used for the journals of the Association for Comput- 
ing Machinery. It has the author name (surname and first name) in small caps, 
and numbers as labels. 
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apalike Alternative BmTgX style, used by the journals of the American Psychology As- 
sociation. It should be used together with the DTpX apalike package. The 
bibliography entries are formatted alphabetically, last name first, each entry 
having a hanging indentation and no label. 


Examples of some other style files are: 

abbrv.bst, abstract. bst, acm.bst, agsm.bst, 
alpha. bst, amsalpha.bst, authordate/.bst, 
authordatei-4.sty, bbs.bst, cbe.bst, cell. bst, 
dcu.bst, harvard. sty, ieeetr.bst, jtb.bst, 


kluwer.bst, named. bst, named. sty, nat- 
bib.sty, natbib.bst, nature. sty, nature. bst, 
phcpc.bst, phiaea.bst, phjcp.bst, phrmp.bst 
plainyr.bst, siam.bst 


Various organisations or individuals have developed style files that correspond to the 
house style of particular journals or editing houses. We can also customise a bibliography 
style, by making small changes to any of the . bst file, or else generate our own using the 
makebst program. 

IV. 2.1. Steps for running BlBTgX with ETpX 

1. Run ETpX, which generates a list of \ci te references in its auxiliary file, . aux. 

2. Run BlBTgX, which reads the auxiliary file, looks up the references in a database 
(one or more .bib files, and then writes a file (the . bbl file) containing the formatted 
references according to the format specified in the style file (the .bst file). Warning 
and error messages are written to the log file (the .big file). It should be noted that 
BllsTpX never reads the original I.TpX source file. 

3. Run ETeX again, which now reads the .bbl reference file. 

4. Run ET^X a third time, resolving all references. 

Occasionally the bibliography is to include publications that were not referenced in 
the text. These may be added with the command 

\noci te{key} 

given anywhere within the main document. It produces no text at all but simply informs 
BibTeX that this reference is also to be put into the bibliography. With \nocite{*}, every 
entry in all the databases will be included, something that is useful when producing a list 
of all entries and their keys. 

After running BibTeX to make up the . bbl file, it is necessary to process ETeX at least 
twice to establish both the bibliography and the in-text reference labels. The bibliography 
will be printed where the \bi bl i ography command is issued; it infact inputs the . bbl file. 


iv.3. Creating a bibliographic database 

Though bibliographic database creation demands more work than typing up a list of 
references with the thebibli ography environment; it has a great advantage that, the en- 
tries need to be included in the database only once and are then available for all future 
publications even if a different bibliography style is demanded in later works, all the in- 
formation is already on hand in the database for BibTeX to write a new thebibli ography 
environment in another format. Given below is a specimen of an entry in bibliographic 
database: 


@B00K{knuth : 86a, 
AUTHOR 


="Donald E. Knuth", 
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TITLE 

EDITION 

PUBLISHER 

ADDRESS 

YEAR 


={The \TeX{}book}, 
="thi rd" 

="Addi son-Wesl ey" , 
={Reading, MA} , 
=1986 } 


The first word, prefixed determines the entry Jype. The entry Jype is followed by 
the reference information for that entry enclosed in curly braces { }. The very first entry 
is the key for the whole reference by which it is referred to in the \ci te command. In the 
above example it is knuth : 86a. The actual reference information is then entered in various 
fields, separated from one another by commas. Each field consists of a field jiame, an = 
sign, with optional spaces on either side, and the field text. The field jiames shows above 
are AUTHOR, TITLE, PUBLISHER, ADDRESS, and YEAR. The field text must be enclosed either 
in curly braces or in double quotation marks. However, if the text consists solely of a 
number, as for YEAR above, the braces or quotation marks may be left off. 

For each entry type, certain fields are required, others are optional, and the rest 
are ignored. These are listed with the description of the various entry types below. If a 
required field is omitted, an error message will appear during the BffiTgX run. Optional 
fields will have their information included in the bibliography if they are present, but 
they need not be there. Ignored fields are useful for including extra information in the 
database that will not be output, such as a comment or an abstract of a paper. Ignored 
fields might also be ones that are used by other database programs. 

The general syntax for entries in the bibliographic database reads 

@entry_type{key , 
field_name = {field text}, 


field_name = {field text} } 

The names of the entry -types as well as the field .names may be written in capitals 
or lower case letters, or in a combination of both. Thus ©BOOK, ©book, and ©book are all 
acceptable variations. 

The outermost pair of braces for the entire entry may be either curly braces { }, as 
illustrated, or parentheses ( ). In the latter case, the general syntax reads 


@entry_type(key , ) 


However, the field text may only be enclosed within curly braces {...} or double quotation 
marks ... as shown in the example above. 

The following is a list of the standard entry types in alphabetical order, with a brief 
description of the types of works for which they are applicable, together with the required 
and optional fields that they take. 


@arti cl e: 
required fields: 
optional fields: 
©book: 

required fields: 
optional fields: 
©book! et: 

required fields: 
optional fields: 


Entry for an article from a journal or magazine. 

author, title, journal, year. 

volume, number, pages, month, note. 

Entry for a book with a definite publisher. 

author or editor, title, publisher, year. 

volume or number, series, address, edition, month, note. 

Entry for a printed and bound work without the name of a publisher 

or sponsoring organisation. 

title. 

author, howpublished, address, month, year, note. 
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©conference: 
required fields: 
optional fields: 

@i nbook: 
required fields: 
optional fields: 
©incollection: 
required fields: 
optional fields: 

@i nproceedi ngs: 
required fields: 
optional fields: 

©manual : 
required fields: 
optional fields: 
©masterthesi s: 
required fields: 
optional fields: 
©mi sc: 

required fields: 
optional fields: 
©phdthesi s: 
required fields: 
optional fields: 
©proceedi ngs: 
required fields: 
optional fields: 

©unpubl i shed: 
required fields: 
optional fields: 


Entry for an article in conference proceedings, 
author, title, booktitle, year. 

editor, volume or number, series, pages, address, month, organisa- 
tion, publisher, note. 

Entry for a part (chapter, section, certain pages) of a book, 
author or editor, title, chapter and/or pages, publisher, year, 
volume or number, series, type, address, edition, month, note. 
Entry for part of a book that has its own title, 
author, title, booktitle, publisher, year. 

editor, volume or number, series, type, chapter, pages, address, edi- 
tion, month, note. 

Entry for an article in conference proceedings, 
author, title, booktitle, year. 

editor, volume or number, series, pages, address, month, organisa- 
tion, publisher, note. 

Entry for technical documentation, 
title. 

author, organisation, address, edition, month, year, note. 

Entry for a Master’s thesis, 
author, title, school, year, 
type, address, month, note. 

Entry for a work that does not fit under any of the others, 
none. 

author, title, howpublished, month, year, note. 

Entry for a PhD thesis, 
author, title, school, year, 
type, address, month, note. 

Entry for conference proceedings, 
title, year. 

editor, volume or number, series, address, month, organisation, 
publisher, note. 

Entry for an unpublished work with an author and title, 
author, title, note, 
month, year. 


IV. 3. i. Example of a DTeX file (sample.tex) using bibliographical database (bsample.bib) 

\documentcl assfarti cl e} 

\pagestyle{empty} 

\begi nfdocument} 


\secti on*{Example of Citations of Kind \texttt{pl ai n}} 

Citation of a normal book"\cite{Ei jkhout:1991} and an edited 
book"\ci tefRoth : postscri pt} . Now we cite an article written by a 
si ngle~\ci tefFel i ci : 1991} and by multiple 
authors~\ci te{Mi ttlebatch/Schoepf : 1990} . A reference to an 
article inside proceedings~\cite{Yannis:1991}. 

We refer to a manual "\ci tefDynatext} and a technical 
report~\ci tefKnuth :WEB} . A citation of an unpublished 
work~\cite{EVH: Office}. A reference to a chapter in a 
book~\cite{Wood: color} and to a PhD thesis"\cite{Liang:1983} . 
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An example of multiple 

ci tati ons~\ci te{Ei j khout : 1991, Roth : postscri pt} . 

\blbllographystyle{plain} %% plain. bst 
\bibliography{bsample} %% bsample.bib 
\end{document} 

IV. 3. 2. Procedure for producing references for the above file sample.tex which uses bib- 
liographic data base bsample.bib 

$ latex sample % 1st run of LaTeX 

$ bibtex sample % BibTeX run 

% Then sample. bbl file will 
% be produced 

$ latex sample % 2nd run of LaTeX 
If still unresolved citation references 

$ latex sample % 3rd run of LaTeX 
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TABLE OF CONTENTS, INDEX AND GLOSSARY 


v.i. Table of contents 

A table of contents is a special list which contains the section numbers and corresponding 
headings as given in the standard form of the sectioning commands, together with the 
page numbers on which they begin. Similar lists exist containing reference information 
about the floating elements in a document, namely, the list of tables and list of figures. 
The structure of these lists is simpler, since their contents, the captions of the floating 
elements, all are on the same level. 

Standard ETeX can automatically create these three contents lists. By default, ETeX 
enters text generated by one of the arguments of the sectioning commands into the . toe 
file. Similarly, ET^X maintains two more files, one for the list of figures ( . 1 of) and one for 
the list of tables ( .lot), which contain the text specified as the argument of the \caption 
command for figures and tables. 

\tableof contents produces a table of contents. \1 i stof figures and \1 i stoftabl es 
produce a list of figures and list of tables respectively. These lists are printed at the 
point where these commands are issued. Occasionally, you may find that you do not 
like the way ETeX prints a table of contents or a list of figures or tables. You can fine- 
tune an individual entry by using the optional arguments to the sectioning command or 
\capti on command that generates it. Formatting commands can also be introduced with 
the \addtocontents. If all else fails, you can edit the . toe, 1 of, I ot files yourself. Edit 
these files only when preparing the final version of your document, and use a \nof i 1 es 
command to suppress the writing of new versions of the files. 

V.i. i. Additional entries 

The "'-form sectioning commands are not entered automatically in the table of contents. 
ETeX offers two commands to insert such information directly into a contents file: 

\addtocontents{/7/e}{fexf} \addcontentsl i ne{/z/e} {type} {text} 

file The extension of the contents file, usually toe, lof or lot. 

type The type of the entry. For the toe file the type is normally the same as 

the heading according to the format of which an entry must be typeset. 
For the lof or lot files, figure or table is specified. 
text The actual information to be written to the file mentioned. ETeX com- 
mands should be protected by \protect to delay expansion 
The \addtocontents command does not contain a type parameter and is intended to 
enter user-specific formatting information. For example, if you want to generate addi- 
tional spacing in the middle of a table of contents, the following command can be issued: 

\addtocontents{toc}{\protect\vspace{2ex}} 
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The \addcontentsl i ne instruction is usually invoked automatically by the document 
sectioning commands, or by the \caption commands. If the entry contains numbered 
text, then \number! i ne must be used to separate the section number ( number ) from the 
rest of the text for the entry (beading) in the text parameter: 

\protect\numberI i n ^.{number} {heading} 

For example, a \caption command inside a figure environment saves the text an- 
notating the figure as follows: 

\addcontentsI i ne{lof){figure}{\protect\numberl i ne{\thefi gurej captioned text } 

Sometimes \addcontentsline is used in the source to complement the actions of 
standard FTpX. For instance, in the case of the starred form of the section commands, no 
information is written to the .toe file. So if you do not want a heading number (starred 
form) but an entry in the . toe file you can write something like: 

\chapter*{Fo rward} 

\addcontentsI i ne{toc}{chapter}{\numberl i ne{} Forward} 

This produces an indented “chapter” entry in the table of contents, leaving the space 
where the chapter number would go free. Omitting the \nutnberl ine command would 
typeset the word “Forward” flush left instead. 

V.i. 2 . Typesetting a contents list 

As discussed above, contents lists consist of entries of different types, corresponding to 
the structural units that they represent. Apart from these standard entries, these lists may 
contain any commands. A standard entry is specified by the command: 

\contentsI i r\e{type} {text} {page } 

type Type of the entry, e.g. section, or figure. 

text Actual text as specified in the argument of the sectioning or \caption 
commands. 

page Pagenumber. 

Note that section numbers are entered as a parameter of the \numberline command 
to allow formatting with the proper indentation. It is also possible for the user to create 
a table of contents by hand with the help of the command \contentsline. For example: 

\contentsI i ne {section} 

{\numberline {2 . 4}Structure of the Table of Contents}{31} 

To format an entry in the table of contents files, standard FTgX makes use of the 
following command: 

\@dottedtocl i ne{level} {indent} {numwidth} {text} {page} 

The last two parameters coincide with those of \contentsli ne, since the latter usu- 
ally invokes \@dottedtocl i ne command. The other parameters are the following: 

level The nesting level of an entry. This parameter allows the user to control 
how many nesting levels will be displayed. Levels greater than the value 
of counter toedepth will not appear in the table of contents. 

indent This is total indentation from the left margin. 

numwidth The width of the box that contains the number if text has a \numberl i ne 
command. This is also the amount of extra indentation added to the 
second and later lines of a multiple line entry. 
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Additionally, the command \@dottedtocl i ne uses the following formatting parame- 
ters, which specify the visual appearance of all entries: 

\@pnumwi dth The width of the box in which the page number is set. 

\@tocmarg The indentation of the right margin for all but the last line of multiple 
line entries. Dimension, but changed with \renewcommand. 

\@dotsep The separation between dots, in mu (math units). It is a pure number 
(like 1.7 or 2). By making this number large enough you can get rid of 
the dots altogether. Changed with \renewcommand as well. 

V. 1 . 3 . Multiple tables of contents 

The minitoc package, initially written by Nigel Ward and Dan Jurafsky and completely 
redesigned by Jean-Pierre Drucbert, creates a mini-table of contents (a “minitoc”) at the 
beginning of each chapter when you use the book or report classes. 

The mini-table of contents will appear at the beginning of a chapter, after the \chapter 
command. The parameters that govern the use of this package are discussed below: 

Table V.i: Summary of the mi ni toe parameters 


\dominitoc 

Must be put just in front of \tabl eof contents, to initialize 
the minitoc system (Mandatory). 

\f aketabl eof contents 

This command replaces \tabl eof contents when you want 
minitocs but not table of contents. 

\mi ni toe 

This command must be put right after each \chapter com- 
mand where a minitoc is desired. 

\mi ni toedepth 

A LfTpX counter that indicates how many levels of head- 
ings will be displayed in the minitoc (default value is 2). 

\mtci ndent 

The length of the left/right indentation of the minitoc (de- 
fault value is 24pt). 

\mtcfont 

Command defining the font that is used for the minitoc 
entries (The default definition is a small roman font). 


For each mini-table, an auxiliary file with extension .mtc<N> where <N> is the chap- 
ter number, will be created. 

By default, these mini-tables contain only references to sections and subsections. The 
minitoedepth counter, similar to toedepth, allows the user to modify this behaviour. 

As the minitoc takes up room on the first page(s) of a chapter, it will alter the page 
numbering. Therefore, three runs normally are needed to get correct information in the 
mini-table of contents. 

To turn off the \mi ni toe commands, merely replace the package mi ni toe with mi ni - 
tocoff on your \usepackage command. This assures that all \minitoc commands will be 
ignored. 


v.2. Index 

To find a topic of interest in a large document, book, or reference work, you usually 
turn to the table of contents or, more often, to the index. Therefore, an index is a very 
important part of a document, and most users’ entry point to a source of information 
is precisely through a pointer in the index. The most generally used index preparation 
program is Makelndex. 
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Page vi: \index(animal| 

Page 5: \index(animal| 

Page 6: \index{animal) 

Page 7: \index(animal| 

Page 11: \index(animalism|seejanimal|) 
Page 17: \indexjanimal@\emph(animal|) 
\index{mammal|textbf) 

Page 26: \index(animal!mammal!cat) 
Page 32: \index(animal!insect) 

(a) The input file 


\begi n{theindex} 

\item animal, vi, 5-7 
\subitem insect, 32 
\subitem mammal 
\subsubitem cat, 2 6 
\item \emphjanimal), 17 
\item animalism, \see{animal){n| 
\i ndexspace 

\item mammal, \textbfl17} 
\end{theindexj 

(c) The . i nd file 


\indexentry{animal}{vi} 

\indexentry { animal} { 3 } 

\indexentry{ animal}} 6} 

\indexentry{ animal}{7} 
\indexentry{animalism|seeanimal} {11} 
\indexentry { animal@\emp h { animal} } {17} 
\indexentry | mammal| textbf } {17} 
\indexentry { animal Imammal ! cat} { 26} 
\indexentry { animal ! insect } { 3 2 } 

(b) The . i dx file 


animal, vi 5-7 
insect, 32 
mammal 
cat, 26 
animal, 17 

animalism, see animal 
mammal, 17 


(d) The typeset output 


Figure V.i: Stepwise development of index processing 


Each \i ndex command causes ET£X to write an entry in the . i dx file. This command 

writes the text given as an argument, in the .idx file. This .idx will be generated only if 

we give \makei ndex command in the preamble otherwise it will produce nothing. 

\i nd ex{index_entry} 

To generate index follow the procedure given below: 

1. Tag the words inside the document, which needs to come as index, as an argument of 
\index command. 

2. Include the makeidx package with an \usepackage command and put \makei ndex com- 
mand at the preamble. 

3. Put a \pri nti ndex command where the index is to appear, normally before \end{documen 
command. 

4. FTpX file. Then a raw index (fi 1 e . i dx) will be generated. 

5. Then run makei ndex. (makeindex file. idx or makeindex file). Then two more files will 
be generated, file.ind which contains the index entries and file.ilg, a transcript file. 

6 . Then run FTgX again. Now you can see in the dvi that the index has been generated 
in a new page. 

V.2.1. Simple index entries 

Each \i ndex command causes ETpX to write an entry in the . i dx file. For example 
\i ndex{index -entry} 
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fonts 

Computer Modem, 13-2.5 
math, see math, fonts 
PostScript, 5 
table, ii-xi, 14 


Page ii: \index{table|(} 

Page xi: \index{table|)} 

Page 5: \index{fonts!PostScript|() 
\index{fonts!PostScript|)) 

Page 13 \index{fonts!Computer Modern |() 
Page 14: \index{table) 

Page 17: \index{fonts!math|see|math, fonts}} 
Page 21: \index{fonts!Computer Modern} 
Page 25: \index{fonts!Computer Modern|)} 


Figure V.2: Page range and cross-referencing 


V.2. 2. Sub entries 

Up to three levels of index entries (main, sub, and subsub entries) are available with 
UTgX-Makelndex. To produce such entries, the argument of the \index command should 
contain both the main and subentries, separated by ! character. 

Page j: \\nde.x{dimensions!rule!widtb} 

This will come out as 

dimensions 

rule 

width, 5 

V.2. 3. Page ranges and cross-references 

You can specify a page range by putting the command \i ndex{ . . . | (} at the beginning of 
the range and \i ndex{ . . . | ) } at the end of the range. Page ranges should span a homoge- 
neous numbering scheme (e.g., Roman and Arabic page numbers cannot fall within the 
same range). 

You can also generate cross-reference index entries without page numbers by using 
the see encapsulator. Since “see” entry does not print any page number, the commands 
\i ndex{ . . . | see{ . . . }} can be placed anywhere in the input file after the \begi nfdocument} 
command. For practical reasons, it is convenient to group all such cross-referencing 
commands in one place. 

V.2. 4. Controlling the presentation form 

Sometimes you may want to sort an entry according to a key, while using a different 
visual representation for the typesetting, such as Greek letters, mathematical symbols, or 
specific typographic forms. This function is available with the syntax: key @visual, where 
key determines the alphabetical position and the string value produces the typeset text of 
the entry. 

For some indexes certain page numbers should be formatted specially, with an italic 
page number (for example) indicating a primary reference, and an n after a page number 
denoting that the item appears in a footnote on that page. Makelndex allows you to 
format an individual page number in any way you want by using the encapsulator syntax 
specified | character. What follows the | sign will “encapsulate” or enclose the page num- 
ber associated with the index entry. For instance, the command \i ndex{keyword|xxx} 
will produce a page number of the form \xxx{n}, where n is the page number in question. 
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delta, 14 

Page ii: 

\index{tabular|textbf) 

6, 23 

Page 5: 

\index|ninety-five) 

delta wing, 16 

Page 7: 

\index{tabbing) 

flower, 19 

Page 14: 

\index{ delta) 

ninety, 2 6 

Page 16: 

\index{delta wing) 

xc, 28 

Page 19: 

\index|flower@\textbf {flower)) 

ninety-five, 5 

Page 21: 

\index{tabular|textit) 

tabbing, 7 , 34-37 

Page 22: 

\index{tabular|nn) 

tabular, ii, 21 , zzn 

Page 23: 

\index{delta@ 5 ) 

tabular environment, 23 


\index{tabular@\texttt{tabular) 

environment) 


Page 26: 

\index{ ninety) 


Page 28: 

\index{ninety@xc) 


Page 34: 

\index{tabbing|(textit) 


Page 36: 

\index{tabbing|)) 

Figure V.3 

Controlling the presentation form 


@ sign, 2 


\i ndex{bar@\texttt{" | } | seefvertical bar}} 

|, see vertical bar 

Page 1: 

\index{quote (\verb+""+)} 

exclamation (!), 4 


\i ndex{quote@\texttt{""} sign} 

Ah!, 5 

Page 2: 

\i ndex{atsign@\texttt{"@} sign} 

Madchen, 3 

Page 3: 

\i ndex{maedchen@M\"{a}dchen} 

quote ("), 1 

Page 4: 

\i ndexfexclamation ("!)} 

" sign, 1 

Page 5: 

\i ndexfexclamation ("!)!Ah"!} 


Figure V.4: Printing those special characters 

Similarly, the command \i ndex{keyword|(xxx)} will generate a page range of the form 
\xxx{n-m} 

\newcommand{\nn} [1] {#ln} 

V.2.5. Printing those special characters 

To typeset one of the characters having a special meaning to Makelndex ( ! , ", @, or | ) 
in the index, precede it with a " character. More precisely, any character is said to be 
quoted if it follows an unquoted " that is not part of a \" command. The latter case is for 
allowing umlaut characters. Quoted !, ", or | characters are treated like ordinary 

characters, losing their special meaning. The " preceding a quoted character is deleted 
before the entries are alphabetised. 

v.3. Glossary 

A ‘glossary’ is a special index of terms and phrases alphabetically ordered together with 
their explanations. To help set up a glossary, ffljX offers the commands 

in the preamble and 
in the text part 


\makegl ossary 

\gl ossary {glossary-entry} 
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which function just like the commands for making up an index register. The entries are 
written to a file with extension .glo after the command \makegl ossary has been given in 
the preamble. The form of these file entries from each \gl ossary command is 

\gl ossaryentry\texti t{gl ossary-entry }{pagenumber} 

The information in the .glo file can be used to establish a glossary. However, there is no 
equivalent to the thei ndex environment for a glossary, but a recommended structure is 
the description environment or a special list environment. 
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DISPLAYED TEXT 


There are many instances in a document when we want to visually separate a portion 
of text from its surrounding material. One method of doing this is to typeset the distin- 
guished text with added indentation. It is called displaying. BTjX has various constructs 
for displaying text depending the nature of the displayed text. 

vi. i. Borrowed words 

Quotations are often used in a document, either to add weight to our arguments by 
referring to a higher authority or because we find that we cannot improve on the way 
an idea has been expressed by someone else. If the quote is a one-liner, we can simply 
include it within double-quotes and be done with it (remember how to use quotes in 
TgX?) But if the quotation is several lines long, it is better to display it. Look at the 
following example: 


Some mathematicians elevate the spirit of Mathematics to a kind of intellectual aesthetics. It 
is best voiced by Bertrand Russell in the following lines. 

The true spirit of delight, the exaltation, the sense of being more than man, which 
is the touchstone of the highest excellence, is to be found in Mathematics as surely 
as in poetry.. . . Real life is, to most men, a long second best, a perpetual compro- 
mise between the ideal and the possible; but the world of pure reason knows no 
compromise, no practical limitations, no barriers to the creative activity embody- 
ing in splendid edifices the passionate aspiration after the perfect, from which all 
great work springs. 

Yes, to men like Russell, Mathematics is more of an art than science. 


This was type set as shown below 

Some mathematicians elevate the spirit of Mathematics to a kind of 
intellectual aesthetics. It is best voiced by Bertrand Russell in the 
following lines. 

\begi n{quote} 

The true spirit of from which 

all great work springs. 

\end{quote} 

Note that here we give instructions to TgX to typeset some material in a separate 
paragraph with additional indentation on either side and indicate the start and end of 
material requiring special treatment, by means of the commands 

\begi nfquote} ... \end{quote} 
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vi. Displayed Text 


This is an example of what is known in ETpX parlance as an environment. Environ- 
ments are used to delimit passages requiring special typographic treatments and to give 
instructions to ETgX on how to typeset it. The general form of an environment is of the 
form 

\begin {name} ... \end {name} 

where name is the name of the environment and signifies to ETgX the type of typographic 

treatment required (deliberate attempt at a pun, that). 

The quoted part in this example is a single paragraph. If the quotation runs into 
several paragraphs, we must use the quotation environment, by enclosing the quotation 
within \begin{quotation} and \end{quotation}. As usual, paragraphs are separated by 
blank lines while typing the source file. 

vi. 2. Poetry in typesetting 

ETpX can write poetry... well almost; if you write poems, TpX can nicely typeset it for 
you. (I have also heard some TgX wizards saying Knuth’s code is sheer poetry!) Look at 
the passage below: 


Contrary to popular belief, limericks are not always ribald. Some of them contain mathemati- 
cal concepts: 

A mathematician once confided 

That a Mobius band is one sided 

You’ll get quite a laugh 

If you cut it in half 

For it stays in one piece when divided 

There is an extension of this to Klein’s bottle also. 


This was typeset as follows: 

Contrary to popular belief, ... tried their hands at it: 

\begi nfverse} 

A mathematician confided\\ 

A M\"obius band is one sided\\ 

You’ll get quite a laugh\\ 

If you cut it in half\\ 

For it stays in one piece when divided 
\end{verse} 

There is an extension of this to Klein’s bottle also. 

Note that line breaks are forced by the symbol \\. Different stanzas are separated 
in the input by one (or more) blank lines. If you do not want TgX to start a new page at 
a particular line break (if you want to keep rhyming couplets together in one page, for 
example), then use \\* instead of plain \\. Again, if you want more space between lines 
than what ETeX deems fit, then use \\ with an optional length as in \\[5pt] which adds 
an extra vertical space of 5 points between the lines. You can also type \\*[5pt], whose 
intention should be obvious by now. 

vi. 3. Making lists 

Lists are needed to keep some semblance of order in a chaotic world and ETeX helps us 
to typeset them nicely. Also, there are different kinds of lists available by default and if 
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none of them suits your need, there are facilities to tweak these or even design your own. 
Let us first have a look at the types of lists LTgX provides. 

VI. 3. i. Saying it with bullets 

The itemize environment gives us a bullet-list. For example it produces something like 
this: 

One should keep the following in mind when using TpX 

• TpX is a typesetting language and not a word processor 

• TgX is a program and and not an application 

• Theres is no meaning in comparing TpX to a word processor, since the design purposes 
are different 

Being a program, TpX offers a high degree of flexibility. 


The input which produces this is given below: 

One should keep the following in mind when using \TeX 
\begi n { i temi ze} 

\item \TeX\ is a typesetting language and not a word processor 
\item \TeX\ is a program and and not an application 

\item Theres is no meaning in comparing \teX\ to a word processor, since the design 
purposes are different 
\end{i temi ze} 

Being a program, \TeX\ offers a high degree of flexibility. 

The \begi n{i temize} ... \end{i temize} pair signifies we want a bullet-list of the 
enclosed material. Each item of the list is specified by (what else?) an \item command. 

We can have lists within lists. For example: 

One should keep the following in mind when using TpX 

• TpX is a typesetting language and not a word processor 

• TpX is a program and and not an application 

• Theres is no meaning in comparing TpX to a word processor, since the design purposes 
are different 

• TpX is the natural choice in one of these situations 

- If we want to typeset a document containing lot of Mathematics 

- If we want our typed document to look beautiful 

Being a program, TpX offers a high degree of flexibility. 

It is produced by the input below: 

One should keep the following in mind when using \TeX 
\begi n { i temi ze} 

\item \TeX\ is a typesetting language and not a word processor 
\item \TeX\ is a program and and not an application 

\item Theres is no meaning in comparing \TeX\ to a word processor, since the design 
purposes are different 

\item \TeX\ is the natural choice in one of these situations 
\begi n{i temi ze} 

\item If we want to typeset a document containing lot of Mathematics 
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\item If we want our typed document to look beautiful 
\end{i temi ze} 

\end{i temi ze} 

Being a program, \TeX\ offers a high degree of flexibility. 

The itemize environment supports four levels of nesting. The full list of labels for the 
items (‘bullets’ for the first level, ‘dashes’ for the second and so on) is as shown below 

• The first item in the first level 

• the second item in the first level 

- The first item in the second level 

- the second item in the second level 

* The first item in the third level 

* the second item in the third level 

• The first item in the fourth level 

• the second item in the fourth level 


Not satisfied with these default labels? How about this one? 

> First item of a new list 

> Second item 

It was produced by the following input: 

{\renewcommand{\l abel i temi }{$\tri angl eri ght$} 

\begi n{i temi ze} 

\i tern Fi rst i tern of a new list 
\item Second item 
\end{i temi ze}} 

Several things need explanation here. First note that the first level labels of the 
i temi ze environment are produced by the (internal and so invisible to the user) command 
\1 abel i temi and by default, this is set as \textbullet to produce the default ‘bullets’. 
What we do here by issuing the \renewcommand is to override this by a choice of our own 
namely $\tri angl eri ght$ which produces the little triangles in the above list. Why the 
braces { and } (did you notice them?) enclosing the whole input? They make the effect 
of the \renewcommand local in the sense that this change of labels is only for this specific 
list. Which means the next time we use an itemize environment, the labels revert back 
to the original ‘bullets’. If we want the labels to be changed in the entire document, then 
remove the braces. 

What if we want to change the second level labels? No problem, just change the 
\1 abel i temi i command, using a symbol of our choice. The third and fourth level labels 
are set by the commands (can you guess?) \1 abel i temi i i and \1 abel i temi v. Look at the 
following example. 
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The first item in the first level 
the second item in the first level 
"3" The first item in the second level 
■s’ the second item in the second level 
$ The first item in the third level 
IS the second item in the third level 

The first item in the fourth level 
the second item in the fourth level 

Here the labels are chosen from the PostScript ZapfDingbats font. We will have to use 
the package pifont, by including the line \usepackage{pi font} in our document preamble 
to access them. The source of the above output is 
\renewcommand{\l abel i temi }{\di ng{42}} 

\renewcommand{\l abel i temi i }{\di ng{43}} 

\renewcommand{\l abel i temi i i }{\di ng{44}} 

\renewcommand{\l abel i temi v}{\di ng{45}} 

\begi n{i temi ze} 

\item The first item in the first level 
\item the second item in the first level 
\begi n { i temi ze} 

\item The first item in the second level 
\item the second item in the second level 
\begi n { i temi ze} 

\item The first item in the third level 
\item the second item in the third level 
\begi n{i temi ze} 

\item The first item in the fourth level 
\item the second item in the fourth level 
\end{i temi ze} 

\end{i temi ze} 

\end{i temi ze} 

\end{i temi ze}} 


vi. 4. When order matters 

When the order of the items in a list is important, we need a list which specifies this order. 
For example, consider this 


The three basic steps in producing a printed document using ETpX are as follows 

1. Prepare a source file with the extension tex 

2. Compile it with ETpX to produce a dvi file 

3 . Print the document using a dvi driver 


Such a numbered list is produced by the enumerate environment in DT£X. The above list 
was produced by the following source. 

\begi nfenumerate} 

\item prepare a source file with the extension "tex" 
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\item Compile it with \LaTeX to produce a "dvi" file 
\item Print the document using a "dvi" driver 
\end{enumerate} 

As in the case of itemize environment, here also four levels of nesting are supports. 
The example below shows the labels used for different levels. 

1. The first item in the first level 

2. the second item in the first level 

(a) The first item in the second level 

(b) the second item in the second level 

i. The first item in the third level 

ii. the second item in the third level 

A. The first item in the fourth level 

B. the second item in the fourth level 

How about customizing the labels? Here there is an additional complication in that 
the labels for items in the same level must follow a sequence (such as 1,2, 3,... for the 
first level, (a), (b), (c),.. .for the second and so on, by default). There is a method for 
doing it, but it will take us into somewhat deeper waters. Fortunately, there is a package 
enumerate by David Carlisle, which makes it easy. So if we want 

The three basic steps in producing a printed document using ETpX are as follows: 

Step 1. Prepare a source file with the extension tex 

Step 2. Compile it with ETpX to produce a dvi file 

i. Use a previewer (such as xdvi on X Window System) to view the output 

ii. Edit the source if needed 

iii. Recompile 

Step 3. Print the document using a dvi driver (such as dvi ps) 
just type the input as follows 

The three basic steps in producing a printed document 
using \LaTeX\ are as follows: 

\begi n {enumerate} [\hspace{0. 5cm}Step 1. ] 

\item Prepare a source file with the extension "tex" 

\item Compile it with \LaTeX to produce a "dvi" file 
\begi n{enumerate} [i . ] 

\item Use a previewer (such as "xdvi" on 

\textsf{X Window System}) to view the output 
\item Edit the source if needed 
\item Recompile 
\end{enumerate} 

\item Print the document using a "dvi" driver 
(such as "dvips") 

\end{enumerate} 

As you can see, the labels Step 1, Step 2 and Step 3 are produced by the optional ar- 
gument Step 1 within square brackets immediately following the first \begi nfenumerate} 
command and the labels i, ii, iii for the second level enumeration are produced by the 
optional [i ] following the second \begi n{enumerate}. So, what is \hspace{0. 5cm} doing 
in the first optional argument? It is to provide an indentation at the left margin of the 
first level items, which the enumerate environment does not produce by default. 
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We can add further embellishments. For example, if we want the labels in the 
first level of the above example to be in boldface, just change the optional argument 
[\hspace{0. 5cm} Step 1] to [\hspace{0. 5cm}\bfseri es Step 1], This produces: 

The three basic steps in producing a printed document using ETpX are as follows: 

Step 1 Prepare a source file with the extension tex 
Step 2 Compile it with ETpX to produce a dvi file 

(a) Use a previewer (such as xdvi on X Window System) to view the output 

(b) Edit the source if needed 

(c) Recompile 

Step 3 Print the document using a dvi driver (such as dvi ps) 


Some care must be taken when we give options like this. Suppose we want to pro- 
duce something like this 

Addition of numbers satisfies the following conditions: 

(Ai) It is commutative 

(Az) It is associative 

(A3 ) There is an additive identity 

(A4) Each number has an additive inverse 

If we give the option [\hspace{lcm}(Al)] as in 

Addition of numbers satisfies the following conditions: 

\begi n{enumerate} [\hspace{lcm}(Al)] 

\item It is commutative 

\item It is associative 

\item There is an additive identity 

\item Each number has an additive inverse 

\end{enumerate} 

Then we get the (somewhat surprising) output 

( 1 1 ) It is commutative 

(22) It is associative 

(33) There is an additive identity 

(44) Each number has an additive inverse 

What happened? In the enumerate package, the option [A] signifies that we want the 
labels to be named in the sequence A, B, C,. . . ,Z (the upper case Roman alphabet) and 
the option [1] signifies we want them as 1,2,3,. • • (the Arabic numerals). Other signifiers 
are [a] for lowercase Roman letters, [I] for uppercase Roman numerals and [i] for 
lowercase Roman numerals. So, if we use any one of these in the optional argument with 
some other purpose in mind, then enclose it in braces. Thus the correct input to generate 
the above example is 

Addition of numbers satisfies the following conditions 
\begi n {enumerate} [\hspace{lcm} ({A}1)] 

\item It is commutative 
\item It is associative 
\item There is an additive identity 
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\item Each number has an additive inverse 
\end{enumerate} 

with braces surrounding the A. (The mystery is not over, is it? How come we got n, 
22,. . . in the above example and not Ai, B2,. . . ? Work it out yourselves!) 

vi. 5. Descriptions and definitions 

There is a third type of list available off-the-shelf in DTeX which is used in typesetting 
lists like this 

Let us take stock of what we have learnt 
TjtX A typesetting program 
Emacs A text editor and also 

a programming environment 
a mailer 

and a lot else besides 
AbiWord A word processor 

This is produced by the description environment as shown below: 

Let us take stock of what we have learnt 
\begi nfdescri pti on} 

\item[\TeX] A typesetting program 
\i tern [Emacs] A text editor and also 
\begi n{descri ption} 

\item a programming environment 
\item a mailer 

\item and a lot else besides 
\end{descri pti on} 

\item[AbiWord] A word processor 
\end{descri pti on} 

Note that this environment does not produce on its own any labels for the various 
items, but only produces as labels, whatever we give inside square brackets immediately 
after each \item. By default, the labels are typeset in boldface roman. Also, there is no 
indentation for the first level. As with the other list environments, these can be changed 
to suit your taste. For example, suppose we want labels to be typeset in sans-serif roman 
and also want an indentation even for the first level. The code below will do the trick 
(remember why we include the whole input within braces?): 

\renewcommand{\descri pti onl abel } [1] {\hspace{lcm}\textsf{#l}} 

Let us take stock of what we have learnt 
\begi n{descri ption} 

\item[\TeX] A typesetting program 
\i tern [Emacs] A text editor and also 
\begi nfdescri pti on} 

\item a programming environment 
\item and a lot else besides 
\end{descri pti on} 

\i tem [AbiWord] A word processor 
\end{descri pti on} 
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and we get the output 

Let us take stock of what we have learnt 
TgX A typesetting program 
Emacs A text editor and also 

a programming environment 
and a lot else besides 
AbiWord A word processor 


Now is perhaps the time to talk about a general feature of all the three list environ- 
ments we have seen. In any of these, we can override the default labels (if any) produced 
by the environment by something of our own by including it within square brackets 
immediately after the \i tern. Thus the input 

The real number $1$ is the least upper bound of the 
set $A$ if it satisfies the following conditions 
\begi n{enumerate} 

\item[(l)] $1$ is an upper bound of $A$ 

\item[(2)] if $u$ is an upper bound of $A$ , then $1 \1 e u$ 

\end{enumerate} 

The second condition is equivalent to 
\begi n{enumerate} 

\item[(2)$’$] If $a<!$, then $a$ is not an upper bound of SAS . 
\end{enumerate} 

produces 

The real number / is the least upper bound of the set A if it satisfies the following conditions 

(i) 1 is an upper bound of A 

(z) if u is an upper bound of A, then / < u 

The second condition is equivalent to 

(z)' If a <1, then a is not an upper bound of A. 


This feature sometimes produces unexpected results. For example, if you type 
Let’s review the notation 
\begi n { i temi ze} 

\item (0,1) is an \emph{open} interval 
\item [0,1] is a \emph{closed} interval 
\end{i temi ze} 

you will get 

Let’s review the notation 

• (o,i) is an open interval 
o,i is a closed interval 

What happened? The 0,1 within square brackets in the second item is interpreted by 
ETeX as the optional label for this item. The correct way to typeset this is 
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Let’s review the notation 
\begi n { i temi ze} 

\item $(0,1)$ is an \emph{open} interval 
\item $ [0 , 1] $ is a \emph{closed} interval 
\end{i temi ze} 

which produces 

Let’s review the notation 

• (0, 1) is an open interval 

• [0, 1] is a closed interval 

So, why the dollars around (0,1) also? Since (0,1) and [0,1] are mathematical entities, 
the correct way to typeset them is to include them within braces in the input, even when 
there is no trouble such as with \item as seen above. (By the way, do you notice any 
difference between (o,i) produced by the input (0,1) and (0,1) produced by $ (0 , 1) $?) 

In addition to all these tweaks, there is also provision in BTpX to design your own 
‘custom’ lists. But that is another story. 




TUTORIAL VII 


ROWS AND COLUMNS 


The various list environments allows us to format some text into visually distinct rows. 
But sometimes the logical structure of the text may require these rows themselves to be 
divided into vertically aligned columns. For example, consider the material below typeset 
using the \description environment (doesn’t it look familiar?) 

Let’s take stock of what we’ve learnt 
Abiword A word processor 
Emacs A text editor 
TgX A typesetting program 

A nicer way to typeset this is 

Let’s take stock of what we’ve learnt 

AbiWord A word processor 

Emacs A text editor 

TjjX A typesetting program 

Here the three rows of text are visually separated into two columns of left aligned text. 
This was produced by the tabbi ng environment in ETgX. 

vii. i. Keeping tabs 


VII. i. i. Basics 

Let’s take stock of what we’ve learnt 
\begi n{tabbi ng} 

\hspace{lcm}\= \textbf {AbiWord}\quad\= A word processor\\[5pt] 

\> \textbf{Emacs} \> A text editor\\[5pt] 

\> \textbf{\TeX} \> A typesetting program 

\end{tabbi ng} 

Let’s analyze it line by line. In the first line the first tab is put at a distance of i cm. from 
the left margin so that the text following it (‘AbiWord’ in boldface roman) starts from 
this point. The second tab is put at a distance of one \quad (this is an inbuilt length 
specification in TgX roughly equal to one space) after the word ‘Abiword’ in boldface 
roman so that the text following it (‘A word processor’ in ordinary roman face) start 
from this point. The \\[5pt] command signifies the end of the first line and also asks 
for a vertical space of 5 points between the first and the second lines. In the second line, 
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the first \> command makes the text following it (‘Emacs’ in boldface roman) to start 
from the first tab (already set in the first line), namely, i cm. from the left margin. The 
second \> line makes the text following it (‘A text editor’ in ordinary roman face) at the 
second tab already set, namely at a distance i cm plus the length of the word ‘AbiWord’ 
in boldface roman plus a \quad. The third line follows suit. The picture below will make 
this clear. 


tab i 

tab 2. 

i 

i 

AbiWord 

A word processor 

Emacs 

A text editor 

T E X 

A typesetting program 


One should be careful in setting tabs. For example to typeset 

T E X A typesetting program 

Emacs A text editor 

AbiWord A word processor 

if you type 

\begi n{tabbi ng} 

\textbf {\TeX}\quad\= A typesetting program\\[5pt] 

\textbf {Emacs}\quad\> A text editor\\[5pt] 

\textbf {AbiWord}\quad\> A word processor 
\end{tabbi ng} 

then you end up with the output 

T E X A typesetting program 
EmacsA text editor 
AbiWo&dword processor 

Do you see what happened? The first line set the first tab (the only tab in this example) at 
a distance of the length of the word ‘TgX’ in boldface roman plus a ‘quad’ from the left 
margin and the \> command in the second line makes the text following to atart from 
this tab, which is right next to the word ‘Emacs’ in this line, the same thing happens 
in the third line, which is worse, since the position of the tab is at the ‘o’ of ’AbiWord’ 
and the next word ‘A word processor’ starts from this point, and overwrites the previous 
word. The correct way to obtain the output we want is to use a dummy line to mark the 
tabs, without actually typesetting that line. This is achieved by the \ki 1 1 command in 
the tabbi ng environment, as shown below 
\begi n{tabbi ng} 

\textbf {AbiWord}\quad\= A word processor\ki 11 
\textbf {\TeX}\quad \> A typesetting program\\[5pt] 
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\textbf {Emacs}\quad \> A text editor\\[5pt] 

\textbf {AbiWord}\quad\> A word processor 
\end{tabbi ng} 

New tabs, in addition to the ones already set by the first line (dummy or otherwise), 
can be set in any subsequent line. Thus the output 

T E X : A typesetting program 

Emacs : A text editor 

a programming environment 
a mail reader 
and a lot more besides 
AbiWord : A word processor 

is obtained from the source 
\begi nftabbi ng} 


\textbf {AbiWord}\quad\= 

\= A 

word processor\ki 1 1 \\ 

\textbf {\TeX}\quad 

\> 

\> A 

typesetting program\\[5pt] 

\textbf {Emacs}\quad 

\> 

\> A 

text editor\\[5pt] 


\> 

\> \quad\= a programming envi ronment\\[5pt] 


\> 

\> 

\> a mail reader\\[5pt] 


\> 

\> 

\> and a lot more besides\\[5pt] 


\textbf {AbiWord}\quad\> : \> A word processor 
\end{tabbi ng} 


Here the first line sets two tabs and the fourth line sets a third tab after these two. All the 
three tabs can then be used in the subsequent lines. New tab positions which change the 
ones set up by the first line, can also be introduced in any line by the \= command. Thus 
we can produce 


Program 

:T E X 



Author 

: Donald Knuth 



Manuals 




Title 


Author 

Publisher 

The Ij'XBook 

Donald Knuth 

Addison-Wesley 

The Advanced TpX Book 

David Salomon 

Springer- Verlag 


by the input 

\begi nftabbi ng} 

Program\quad \= : \= \TeX\\[5pt] 

Author \> : \> Donald Knuth\\[5pt] 

Manuals \> :\\ 

\quad\= The Advanced \TeX\ Book\quad\= David Salomon\quad 

\= Springer-Verlag\kill\\ 

\>\textsf {Ti tie} \>\textsf{Author} \>\textsf{Publ i sher}\\[8pt] 
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\>The \TeX Book \>Donald Knuth \>Addi son-Wesl ey\\[5pt] 

\>The Advanced \TeX\ Book \>David Salomon \>Spri nger-Verl ag 

\end{tabbi ng} 

Here the first line sets teo tabs and the next two lines use these tabs. The third line sets 
three new tabs which replace the original tab positions. The next three lines use these 
new tab positions. 

VII. i. 2. Pushing and popping 

What if you change the tab positions and then want the original settings back? Here’s 
where the command pair \pushtabs . . . \poptabs ia useful. Thus to typeset 

Program : TpX 
Author : Donald Knuth 
Manuals : 

Title Author Publisher 

The TpXBook Donald Knuth Addison- Wesley 

The Advanced TgX Book David Salomon Springer- Verlag 

Tutorial : http://tug.org.in/tutorial 
we type 

\begi n{tabbi ng} 

Program\quad \= : \= \TeX\\[5pt] 

Author \> : \> Donald Knuth\\[5pt] 

Manuals \> :\\ 

\pushtabs 

\quad\= The Advanced \TeX\ Book \quad \= David Salomon \quad 
\= Spri nger-Verl ag\ki 1 1 \\ 

\>\textsf{Ti tie} \>\textsf{Author} \>\textsf{Publ i sher}\\[8pt] 

\>The \TeX Book \>Donald Knuth \>Addi son-Wesl ey\\[5pt] 

\>The Advanced \TeX\ Book \>David Salomon \> Spri nger-Verl ag\\[8pt] 

\poptabs 

Tutorial \> : \> "http://tug.org.in/tutorial" 

\end{tabbi ng} 

Here the first three lines follow a tabbing scheme, the next three lines follow another 
tabbing scheme and the last line reverts back to the original scheme. Here the \pushtabs 
command stores the current tabbing scheme and removes it so that a new tabbing scheme 
can be set up; and the \poptabs commands reactivates the original scheme. These com- 
mands can be nested. 

VII. i. 3. More commands 

There are some more useful commands available in the tabbi ng environment. The \+ 
command given at the end of a line makes every subsequent line start at the first tab; 
with \+\+ at the end of a line, all subsequent lines start at the second tab and so on. 
The effect of each \+ can be neutralized by one \- command at the end of a line. The 
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command \< at the beginning of a line neutralizes the effect of one \+ command for that 
particular line. 

The command \‘ (left quote) puts the text following flush right against the right 
margin. Naturally we cannot use a \= or \> after this in a line. 

Another interesting command is V (right quote). Within the tabbing environment 
an input of the form ieft_text\’ right.text puts the right.text at the current tab and 
the ieft_text just before this tab with a bit of spacing (preassigned by the parameter 
\tabbi ngsep). 

The example below illustrates all the tabbing commands we’ve discussed 


\begi nftabbi ng} 

Row 1 Column l\hspace{2cm} 

\= Row 1 Column 2\\[5pt] 
\> Row 2 


\< Row 5 Col umn 


Column 2\hspace{l. 5cm}\=Row 2 

Row 3 

Row 4 Col umn 2 \>Row 4 

1 \> Row 5 Column 2 \>Row 5 

Row 6 Column 2 \>Row 6 

\> Row 7 Column 2 \>Row 7 


Column 3\+\+\\[5pt] 
Column 3\-\\ [ 5 pt ] 
Column 3\\ [ 5 pt ] 
Column 3\\ [ 5 pt ] 
Column 3\-\\ [ 5 pt ] 
Column 3\\ [ 5 pt ] 
\‘Right\\[5pt] 


\> and\’Row 9 Column 2\\[5pt] 


Row 7 Column 1 
Row 8 Column 1 
Row 9 Col umn 1 
\pushtabs 

\quad\= Row 10 New Column l\hspace{2 . 5cm}\= Row 10 New Column 2\\[5pt] 
\> Row 11 New Column 2 \> Row 11 New Column 2\\[5pt] 

\poptabs 

Row 12 Old Column 1\> Row 12 Old Column 2\>Row 12 Old Column 3 
\end{tabbi ng} 


It produces the following output 


Row i Column i 

Row 1 Column 2 



Row 2 Column 2 

Row 2 Column 3 



Row 3 Column3 


Row 4 Column 2 

Row 4 Column 3 

Row j Column i 

Row 5 Column 2 

Row 5 Column 3 


Row 6 Column 2 

Row 6 Column 3 

Row 7 Column i 

Row 7 Column 2 

Row 7 Column 3 

Row 8 Column i 



Row 9 Column i 

and Row 9 Column 2 


Row io New Column i 

Row 10 

New Column 2 

Row ii New Column 2 

0 

H 

H 

New Column 2 

Row 12 Old Column 1 

Row 12 Old Column 2 Row 12 Old Column 


Recall that the commands \=. V and V are used for various accents outside the 
tabbi ng environment. If these are needed within the tabbi ng environment, they can be 
produced with the commands \a=. \a‘ or \a’ commands. 

One final word. You might’ve noted in the examples above that we give a sort of 
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‘formatting’ to the sources also. This is not really necessary from the point of view of 
LTpX since the output of the last example is he same even if we input 
\begi nftabbi ng} 

Row 1 Column l\hspace{2cm}\=Row 1 Column 2\\[5pt] 

\>Row 2 Column 2\hspace{l. 5cm}\=Row 2 Column 3\+\+\\[5pt] 

Row 3 Column3\-\\[5pt] 

Row 4 Column 2\>Row 4 Column 3\\ [ 5 pt ] 

\<Row 5 Column\>Row 5 Column 2\>Row 5 Column 3\\[5pt] 

Row 6 Column 2\>Row 6 Column 3\-\\[5pt] 

Row 7 Column l\>Row 7 Column 2\>Row 7 Column 3\\[5pt] 

Row 8 Column l\‘\textbf{Flush right}\\[5pt] 

Row 9 Column l\>and\’Row 9 Column 2\\[5pt] 

\pushtabs 

Row 10 New Column l\hspace{2 . 5cm}\=Row 10 New Column 2\\[5pt] 

Row 11 New Column 2\>Row 11 New Column 2\\[5pt] 

\poptabs 

Row 12 Old Column l\>Row 12 Old Column 2\>Row 12 Old Column 3 
\end{tabbi ng} 

LTpX can make sense out of this, but we humans cannot. And such a jumble makes 
editing a hopeless task. The moral? Keep the source (humanly) readable. 

vii. 2. Tables 

Another way to format text into columns and rows is to use the tabular environment. 
Let’s see it in action by means of an example. 


The table below shows the sizes of the planets of our solar system. 


Planet 

Diameter(km) 

Mercury 

4878 

Venus 

12104 

Earth 

12756 

Mars 

6794 

Jupiter 

142984 

Saturn 

120536 

Uranus 

51118 

Neptune 

4953 2 

Pluto 

2274 


As can be seen, Pluto is the smallest and Jupiter the largest 


Now look at the source of this output 

The table below shows the sizes of the planets of our solar system. 
\begi nfcenter} 

\begi nftabul ar}{! r} 

Planet & Diameter(km)\\[5pt] 

Mercury & 4878\\ 

Venus & 12104\\ 

Earth & 12756W 
Mars & 6794\\ 

Jupiter & 142984W 
Saturn & 120536W 
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Uranus & 51118W 
Neptune & 49532\\ 

Pluto & 2274 
\end{tabul ar} 

\end{center} 

As can be seen, Pluto is the smallest and Dupiter the largest 

The \begi n{center} . . . \end{center} commands centralize the table. The table itself is 
produced by the \begin{tabular} . . .\end{tabular} commands. The {1 r} specification 
immediately after the \begin{tabular} indicates there are two columns in the table with 
the entries in the first column aligned on the left and the entries in the second column 
aligned on the right. The entries in each column are separated by the & symbol and the 
terminatio of each row is signalled by the \\ symbol. The \\[5pt] after the first row 
specifies as usual, an additional vertical space of 5 points after this row in the output. 

In addition to the column specifiers 1 and r we also have a specifier c which makes 
the entries in the corresponding column centrally aligned. For example the input 


\begi n{center} 

\begi n{tabul ar}{cr} 

Planet & Diameter(km)\\[5pt] 
Mercury & 4878\\ 

Venus & 12104\\ 

Earth & 12756W 
Mars & 6794\\ 

Dupiter & 142984\\ 

Saturn & 120536W 
Uranus & 51118W 
Neptune & 49532\\ 

Pluto & 2274 
\end{tabul ar} 

\end{center} 


produces the output below 


Planet 

Diameter(km) 

Mercury 

4878 

Venus 

12104 

Earth 

12756 

Mars 

6794 

Jupiter 

142984 

Saturn 

120536 

Uranus 

51118 

Neptune 

4953 2 

Pluto 

2274 


There’s yet another column specifier p which allows us to set column entries in a box 
of specified width (technically a “parbox” — see Chapter x). Suppose you want something 
like this 
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Planet Features 


Mercury 

Venus 

Earth 

Mars 

Jupiter 

Saturn 

Uranus 

Neptune 

Pluto 


Lunar like crust, crustal faulting, small magnetic fields. 

Shrouded in clouds, undulating surface with highlands, plains, lowlands 
and craters. 

Ocens of water filling lowlands between continents, unique in supporting 
life, magnetic field. 

Cratered uplands, lowland plains, volcanic regions. 

Covered by clouds, dark ring of dust, magnetic field. 

Several cloud layers, magnetic field, thousands of rings. 

Layers of cloud and mist, magentic field, some rings. 

Unable to detect from earth. 

Unable to detect from earth 


It is produced from the input 
\begi njcenter} 

\begi nftabul ar}{! p{ . 8\1 i newidth}} 

Planet & Features\\[5pt] 

Mercury & Lunar like crust, crustal faulting, small magnetic 
fields. \\ 


Venus & Shrouded in clouds, undulating surface with highlands, 
plains, lowlands and craters. \\ 

Earth & Ocens of water filling lowlands between continents, 
unique in supporting life, magnetic field.\\ 

Mars & Cratered uplands, lowland plains, volcanic regions. \\ 

Jupiter & Covered by clouds, dark ring of dust, magnetic field. \\ 

Saturn & Several cloud layers, magnetic field, thousands 
of rings. \\ 

Uranus & Layers of cloud and mist, magentic field, some rings. \\ 

Neptune & Unable to detect from earth. \\ 

Pluto & Unable to detect from earth 
\end{tabul ar} 

\end{center} 

Here the specification p{6cm} shows that in a “paragraph box” of width 6 cm. In a p-type 
column, if a \raggedright or \centering is given, then we can induce explicit line breaks 
ivitbin that column by the \\ command. If such commands are used in the last column 
of a row, then the command \tabul arnewl i ne should be used to terminate that row as in 
this example: 

\begi nfcenter} 

\begi nftabul ar}{l p{6cm}} 

Planet & Features\tabul arnewl i ne [8pt] 

Mercury & \raggedright Lunar like crust\\ 

Crustal faulti ng\\ 

Small magnetic fiels\tabularnewline[3pt] 

Venus & \raggedright Shrouded in clouds\\ 

Undul ati ng surface\tabul arnewl i ne [3pt] 

Earth & \raggedright Ocens of water\\ 

Unique in supporting life\\ 

Magneti c fi el d\tabul arnewl i ne [3pt] 

Mars & \raggedright Cratered uplands\\ 
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Lowland plains\\ 

Vol cani c regi ons\tabul arnewl i ne [Bpt] 
Jupiter & \raggedright Covered by clouds\\ 

Dark ring of dust\\ 

Magneti c fi el d\tabul arnewl i ne [3pt] 
Saturn & \raggedright Several cloud layers Magnetic field\\ 

Thousands of rings\tabularnewline[3pt] 
Uranus & \raggedright Layers of cloud and mi st\\ 

Magentic field\\ 

Some ri ngs\tabul arnewl i ne [3pt] 

Neptune & Unable to detect 

from earth\tabularnewline[3pt] 
Pluto & Unable to detect 

from earth\tabularnewline[3pt] 

\end{tabul ar} 

\end{center} 


This produces the output below 


Planet 

Features 

Mercury 

Lunar like crust 
Crustal faulting 
Small magnetic fiels 

Venus 

Shrouded in clouds 
Undulating surface 

Earth 

Ocens of water 
Unique in supporting life 
Magnetic field 

Mars 

Cratered uplands 
Lowland plains 
Volcanic regions 

Jupiter 

Covered by clouds 
Dark ring of dust 
Magnetic field 

Saturn 

Several cloud layers 
Magnetic field 
Thousands of rings 

Uranus 

Layers of cloud and mist 
Magentic field 
Some rings 

Neptune 

Unable to detect from earth 

Pluto 

Unable to detect from earth 


Note that the last two lines don’t need a \raggedright command, since there are no 
explicit linebreaks in them. 

A table usually contains horizonntal and vertical lines separating the rows and 
columns. These can also be produced in the tabular environment. For example, the 
first table we saw above can be typeset as 
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Planet 

Diameter(km) 

Mercury 

4878 

Venus 

12104 

Earth 

12756 

Mars 

6794 

Jupiter 

142984 

Saturn 

120536 

Uranus 

51118 

Neptune 

4953 2 

Pluto 

2274 


by the input 
\begi n{center} 

\begi njtabul ar}{ 1 1 | r | } 

\hl i ne 

Planet & Di ameter(km)\\ 
\hl i ne 

Mercury & 4878\\ 


Pluto & 2274\\ 

\hl i ne 

\end{tabul ar} 

\end{center} 

Do you see what produced the vertical and horizontal lines? Instead of the specification 
{1 r} used earlier, we now have { 1 1 1 r | } The character | causes a vertical line to be drawn 
at the specified location, running down the entire height of the table. (Two | ’s in succes- 
sion produce a double vertical lines.) An \hl i ne command after a row draws a horizontal 
line after that row, running along the entire width of the table. (Again, two \hl i ne’s in 
succession producea double horizontal line.) Note also that because of the last \hline , 
we should give a line termination command \\ at the end of the last row also. 

Now suppose we want to produce something like this 


Planet 

Distance from sun (km) 


Maximum 

Minimum 

Mercury 

69400000 

46800000 

Venus 

109000000 

107600000 

Earth 

152600000 

147400000 

Mars 

249200000 

207300000 

Jupiter 

817400000 

741600000 

Saturn 

1 5 12000000 

1346000000 

Uranus 

301 1000000 

2740000000 


Here, there are three columns and the entry Distance from the sun (km) is to span the 
the last two columns below it. The command \multi column does the trick as shown 
below 

\begi n{center} 

\begi n{tabui ar}{! rr} 

Planet & \mul ticol umn{2}{c | }{Di stance from sun (km)}\\ 

& Maximum & Minimum\\ 
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Mercury & 69400000 & 46800000W 

Venus & 109000000 & 107600000W 

Earth & 152600000 & 147400000W 

Mars & 249200000 & 207300000W 

Jupiter & 817400000 & 741600000W 

Saturn & 1512000000 & 1346000000W 
Uranus & 3011000000 & 2740000000W 
\end{tabul ar} 

\end{center} 

The entry \multicolumn{2}{c}{Distance from sun (km)} indicates that the item within 
the last set of braces is to span two columns as specified by the 2 within the first set of 
braces. The entry c within the second set of bracesindicates that this text is to be centered 
within the column. Thus the general form of the command is 

\mul ti col umr\{num}{pos}}item} 

where num is the number of columns to be spanned, pos is the position of the item within 
the column and item is the text of the item. Note also that the input for the second row 
starts with an & character. This is because there is no entry in the first column of the 
second row. 

Now what if you want 


Planet 

Distance from sun (km) 

Maximum 

Minimum 

Mercury 

Venus 

Earth 

Mars 

Jupiter 

Saturn 

Uranus 

Neptune 

Pluto 

694OOOOO 
109000000 
152600000 
249200000 
817400000 
I 5 12000000 
301 IOOOOOO 
4543000000 
7346000000 

46800000 

107600000 

147400000 

207300000 

741600000 

r346oooooo 

2740000000 

4466000000 

4461000000 


Here the first few lines and the last lines of the input are as below (the other lines are the 
same as in the previous example). 

\begi n{center} 

\begi n{tabul ar}{ 1 1 I r | r | } 

\hl i ne 

Planet & \mul ticol umn{2}{c | }{Di stance from sun (km)}\\ 

\cl i ne{2-3} 

& Maximum & Minimum\\ 

\hl i ne 


\hl i ne 

\end{tabul ar} 

\end{center} 

Note that the position specifier in the \multi column command here is c | . This has to 
do with the way the environment splits the column specification into various columns. 
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For example, the specification 1 1 | r | r | in this exaple is split into |1 I , r | and r | and 
the \multicolumn{2} command resets the last two columns. In particular, the final | gets 
reset and we’ll have to explicitly supply it in the position specification of the \mul ti col umn 
command as c | . 

Note also the command \cline{2-3} after the first row. This draws a horizontal 
line from the second to the third column. In general the command \cline{/-/'} draws a 
horizontal line from the 1 th column to the ; th column. 

Another feature of the \multicolumn command is that with \multicolumn{l} we can 
override the position specification of any column set at the beginning of the environment. 
For example, consider the input below 
\begi n{center} 

\begi n{tabul ar}{ 1 1 I r | r | } 

\hl i ne 

& \mul ticol umn{2}{p{3 . 5cm } | }% 

{\centering Distance from sun \\ (million km)}\\ 

\cl i ne{2-3} 

\mul ti col umn{l}{ | c | }{P1 anet} 

& \mul ticol umn{l}{c | }{Maximum} 

& \mul ti col umn{l}{c | > {Mi nimum}\\ 

\hl i ne 

Mercury & 69.4 & 46.8\\ 

Venus & 109.0 & 107. 6\\ 

Earth & 152.6 & 147. 4\\ 

Mars & 249.2 & 207. 3\\ 

Jupiter & 817.4 & 741. 6\\ 

Saturn & 1512.0 & 1346. 0\\ 

Uranus & 3011.0 & 2740. 0\\ 

Neptune & 4543.0 & 4466. 0\\ 

Pluto & 7346.0 & 4461. 0\\ 

\hl i ne 

\end{tabul ar} 

\end{center} 

It produces the output below 


Planet 

Distance from sun 
(million km) 

Maximum 

Minimum 

Mercury 

69.4 

46.8 

Venus 

109.0 

107.6 

Earth 

152.6 

147-4 

Mars 

249.2 

207.3 

Jupiter 

817.4 

741.6 

Saturn 

1512. 0 

1346.0 

Uranus 

3011. 0 

2740.0 

Neptune 

4543.0 

4466.0 

Pluto 

7346.0 

4461.0 


Note that even though \centeri ng is used in the last column of the first row, no \tabul arnewl i ne 
is required to terminate this row, since the scope of the \centering is limited by the 
\mul ti col umn. 
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By the way, do you feel that the tables we’ve been produced look a bit cramped? A 
bit crowded vertically? Well, you can create a bit more room between rows by redefining 
the value of \arraystretch. By default, it’s value is 1 and if you set it to a number k, 
then the interrow space is increased k-fold. Thus the input of the last example with the 
command 

\renewcommand{\arrayst retch} {1. 2} 
after the \begin{center} produces 


Planet 

Distance from sun 
(million km) 

Maximum 

Minimum 

Mercury 

69.4 

46.8 

Venus 

109.0 

107.6 

Earth 

152.6 

147-4 

Mars 

249.2 

207.3 

Jupiter 

817.4 

741.6 

Saturn 

1512. 0 

1346.0 

Uranus 

3011. 0 

2740.0 

Neptune 

4543.0 

4466.0 

Pluto 

7346.0 

4461.0 


Next let’s see how we produce a table like the one below 


Height 

(cm) 

Ideal weight 
(kg) 

T 55 

53 - 5-64 

160 

56-67 

165 

59 - 7 i 

170 

62.5-75.5 

T 75 

66-79 

180 

70-83.5 

00 

H 

71.5-86.5 

190 

78-92.5 


Here we want all the dashes in the second column to be vertically aligned, so that we must 
set them in a separate column; but then there should be no space between the numbers 
and the dashes connecting them. In such cases we can use the @ command in the column 
specification as below 
\begi n{center} 

\begi n{tabul ar}{ | c | r@{--}l | } 

\hl i ne 

Height & \mui ticoi umn{2}{c | }{Ideal weight}\\ 

(cm) & \mui ti coi umn{2}{c | }{(kg)}\\ 

\hl i ne 

155 & 55.5 & 64 \\ 

160 & 56 & 67 \\ 


190 & 78 & 92 . 5 W 
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\hl i ne 

\end{tabul ar} 

\end{center} 

Here the specification r@{--}l indicates that there should be a right aligned column and 
a left aligned column with a - in between each pair of entries in these columns without 
the intercolumn space the tabular environment leaves by default between every pair of 
columns. Note that this incidently saves us the trouble of repeatedly typing You 
can also add some space producing commands within the braces after the @ command to 
produce that much space between the columns on either side of it. 

VII. 2. i. Enhancements to the tabular 

There are many packages which provide further facilities in forming tables. We’ll discuss 
a couple of such packages here. 

vn. 2. 2. The array package 
Look at the tables below 


Planet 

Mean distance 
from sun 
(km) 


Planet 

Mean distance 
from sun 
(km) 

Mercury 

58100000 


Mercury 

58100000 

Venus 

108300000 


Venus 

108300000 

Earth 

150000000 


Earth 

150000000 

Mars 

228250000 


Mars 

228250000 

Jupiter 

779500000 


Jupiter 

779500000 

Saturn 

1429000000 


Saturn 

1429000000 

Uranus 

2439000000 


Uranus 

2439000000 

Neptune 

4504500000 


Neptune 

4504500000 

Pluto 

59035 00 000 


Pluto 

59035 0C >000 


The one on the right looks nicer, doesn’t it? It was produced using the column specifier m 
available in the array package. To produce this table, we must first load the array package 
by the ususl \usepackage{array} in the preamble and then type 

\begi n{tabul ar}{ | 1 | r | } 

\hl i ne 

\mul ti col umn{l}{ | m{ 1 . 5cm} | }{\centeri ng PI anet} 

&\mul ti col umn{l}{m{2 . 3cm} | }% 

{\centering Mean distance from sun \\ (km)}\\ 

\hl i ne 

Mercury & 58100000W 


Pluto & 5903500000W 
\hl i ne 

\end{tabul ar} 

The m {wd} specifier produces a column of width wd just like the p specifier, but with the 
text aligned vertically in the middle unlike the p specifier which aligns the text with the 
topline. (The table on the left, incidently, was produced by the same input as above but 
with p instead of m). 
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Another interesting feature of the array package is the >{decl} command which can 
be used before a column specifier. It inserts decl directly in front of the column. For 
example look at the input below 


\begi nfcenter} 

\begi nftabul ar}{ | >{\bfseri es}l | r | } 

\hl i ne 

\mul ti col umn{l}{ | m{l. 5cm} | }{\centeri ng PI anet} 

&\mul ti col umn{l}{m{2 . 3cm} | }% 

{\centering Mean distance from sun \\ (km)}\\ 

\hl i ne 

Mercury & 58100000W 
Venus & 108300000W 
Earth & 150000000W 
Mars & 228250000W 
Jupiter & 779500000W 
Saturn & 1429000000W 
Uranus & 2439000000W 
Neptune & 4504500000W 
Pluto & 5903500000W 
\hl i ne 

\end{tabul ar} 

\end{center} 


which produces the output 


Planet 

Mean distance 
from sun 
(km) 

Mercury 

58100000 

Venus 

108300000 

Earth 

150000000 

Mars 

228250000 

Jupiter 

779500000 

Saturn 

1429000000 

Uranus 

2439000000 

Neptune 

4504500000 

Pluto 

59°35 00000 


The array package also has a ! command which works just like the @ command, but 
whch does not suppress the intercolumn space. 


Vii. 2. 3. The multi row package 

Look again at the table in 68. Wouldn’t it be nice if the entry “Planet” in the first column 
is vertically aligned with the center of the two rows in the next column as below? 
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Planet 

Distance from sun 
(million km) 

Maximum 

Minimum 

Mercury 

69.4 

46.8 

Venus 

109.0 

107.6 

Earth 

152.6 

147-4 

Mars 

249.2 

207.3 

Jupiter 

817.4 

741.6 

Saturn 

1512. 0 

1346.0 

Uranus 

3011. 0 

2740.0 

Neptune 

4543.0 

4466.0 

Pluto 

7346.0 

446 l.O 


The package multi row is what we need to do this painlessly. It has a command 


\mu1ti row {man} {wd} {item} 


where num is the number of rows to be spanned, wd is the width of this column and item 
is the text of the item in this column. This can be used as in the following example 


\begi n{center} 

\begi n{tabul ar}{ 1 1 | r | r | } 

\hl i ne 

\mul ti row{3}{l. 5cm} {PI anet} 

& \mul ticol umn{2}{p{3 . 5cm} | }% 

{\centering Distance from sun \\ (million km)}\\ 

\cl i ne{2-3} 


\hl i ne 


& \mul ticol umn{l}{c | }{Maximum} 

& \mul ti col umn{l}{c | }{Mi nimum}\\ 


Mercury & 69.4 & 46.8\\ 

Venus & 109.0 & 107. 6\\ 

Earth & 152.6 & 147. 4\\ 

Mars & 249.2 & 207. 3\\ 

Jupiter & 817.4 & 741. 6\\ 

Saturn & 1512.0 & 1346. 0\\ 
Uranus & 3011.0 & 2740. 0\\ 
Neptune & 4543.0 & 4466. 0\\ 
Pluto & 7346.0 & 4461. 0\\ 


\hl i ne 


\end{tabul ar} 
\end{center} 


But this code does not produce the table above, but only 
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Planet 

Distance from sun 
(million km) 

Maximum 

Minimum 

Mercury 

69.4 

46.8 

Venus 

109.0 

107.6 

Earth 

152.6 

147-4 

Mars 

249.2 

207.3 

Jupiter 

817.4 

741.6 

Saturn 

1512. 0 

1346.0 

Uranus 

3011. 0 

2740.0 

Neptune 

4543-0 

4466.0 

Pluto 

7346.0 

4461.0 


The trouble is that though the entry “Planet” is vertically centered in its column, it 
is not horizontally centered. The horizontal alignment is controlled by the command 
\multi rowsetup and this is by default st to \raggedright. So all that is needed to get the 
beautiful table seen at the beginning of this section is to add the line 

\renewcommand{\multi rowsetup}{\centeri ng} 

at the beginning of the code above. 

VII. 2. 4. tabbi ng vs. tabul ar 

Let’s take a quick look at the pros and cons of the tabbi ng and tabul ar environments. 

• The tabbi ng environment can be typeset only as a separate paragraph, while the 
tabular environment can be placed anywhere in text, even inside Mathematics. 

• The tabbing environment can span multiple pages, but the tabular environment 
cannot. 

• tabbi ng environments cannot be nested, while tabul ar environments can be nested 
to any number of levels. 

Vii. 2. 5. Multipage tables — The package longtable 

As we have noted, we cannot create table spanning more than one page using the tabul ar 
environment. But the package longtable by David Carlisle can do this and it has quite a 
few other tricks also. To use this package, load it as usual with the command \usepackage{l ongtabl e} 
in the preamble and then to produce a no-frills “longtable” just use the commands 
\begi n { 1 ongtabl e} ... \end{l ongtabl e} instead of the \begi n{tabular} .. . \end{tabul ar} 
commands. We can use footnotes and the \newpage commands inside the longtable en- 
vironment. If the package array is also loaded, its extra features can be used. 

Apart from this, this package has provisions to specify at the start of the input the 
following items 

• the rows that should appear at the top of the table ; the input for these to be termi- 
nated by \endf i rsthead 

• the rows that should appear in every page after the first , such input terminated by 
\endhead 

• those at the bottom of every page, the input terminated by \endfoot 
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• those rows at the very end of the table, terminated by \endlastfoot 
These are illustrated in the (long!) table below. 


Science and Technology in the Twentieth Century 


Year 

Event 

1900 

Max Planck proposes quantum theory 

Publication of Sigmund Freud’s The Interpretation of Dreams 

1901 

Discovery of principal blood groups 

Guglielmo Marconi transmits wireless signals across the atlantic 

1903 

Wright brothers make their first flight 

1905 

Albert Einstein presents Special Theory of Relativity 

I9II 

Ernest Rutherford proposes theory of atomic structure 

1912 

Victor Eless discovers cosmic rays 

1916 

Albert Einstein presents general Theory of Relativity 

1920 

Radio broadcasting begins 

1926 

John Logie Baird demonstrates television 

1928 

Alexander Fleming discovers penicillin 

1933 

Discovery of polythene 

1934 

Discovery of nuclear fission 

1938 

Discovery of nylon 

1940 

Plutonium obtained by bombardment of uranium 

1942 

Construction of first nuclear reactor 

1946 

Construction of first electronic digital computer 

1947 

First supersonic flight 
Invention of the transistor 

1951 

Nuclear power stations introduced 

1953 

James Watson and Francis Crick show DNS molecule structure 

1956 

Contraceptive pill introduced 

1957 

Launch of the first space satellite ( Sputnik 1 ) 

1959 

First photograph of the dark side of the moon (Luna 3) 

1961 

Yuri Gagarin becomes first man in space (Vostok 1) 

1 966 

First lunar soft landing ( Luna 9) 

1967 

Discovery of pulsars 

1968 

First manned lunar orbit (Apollo 8) 

1969 

First man on moon (Neil Armstrong) 

1972 

Pocket calculator introduced 


continued on the next page 
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Science and Technology in the Twentieth Century ( continued ) 


Year 

Event 

1974 

First ‘test-tube babies’ 

1977 

Launch of Voyager missions to outer spce 

1983 

IBM personal computer launched 

1986 

Flailey’s comet intercepted 

1997 

Cloning of “Dolly” the sheep 

2000 

Decoding of 90% of human genome completed 


Source : The Cambrige Factfinder 


Part of the code to produce this is given below. 

\renewcommand{\ar ray st retch} {1. 2} 

\begi n{longtabl e}{ | c | 1 1} 

\mul ti col umn{2}{c}% 

{\textbf {Sci ence and Technology in the Twentieth Century}}\\[5pt] 

\hl i ne 

\mul ti col umn{l}{ | c | }{\sffami ly Year} 

&\mul ti col umn{l}{ | c | }{\sffami ly Event}\\ 

\hl i ne 

\endf i rsthead 
\mul ti col umn{2}{c}% 

{\textbf {Science and Technology in the Twentieth Century} 

(\texti t{conti nued})}\\[5pt] 

\hl i ne 

\mul ti col umn{l}{ | c | }{\sffami ly Year} 

&\mul ti col umn{l}{ | c | }{\sffami ly Event}\\ 

\hl i ne 
\endhead 
\hl i ne 

\multicolumn{2}{r}{\small\itshape continued on the next page}\\ 

\endfoot 

\hl i ne 

\multicolumn{2}{r}{\small Source\, :\,\itshape The Cambrige Factfinder} 
\endl astfoot 

1900 & Max Planck proposes quantum theoryW 


2000 & Decoding of 90\% of human genome completed\\ 
\hl i ne 

\end{longtabl e} 


VII. 2. 6. And that’s not all! 

There are many more packages which help to produce tables of various requirements. Be 
sure to check out the pakages tabularx, delarray, dcolumn and hhline. 
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TUTORIAL VIII 


TYPESETTING MATHEMATICS 


Donal Knuth created TgX primarily to typeset Mathematics beautifully. LTpX includes all 
the capabilities of TgX in Mathematics typesetting, sometimes with easier user interfaces. 
Then there are packages like amsmath which enhance and refine these interfaces. 

viii. i. The basics 

A mathematical expression occurring in running text (called in-text math) is produced by 
enclosing it between dollar signs. Thus to produce 


The equation representing a straight line in the Cartesian plane is of the form ax + by + c = 0, 
where a, b, c are constants. 

we type 

The equation representing a straight line in the Cartesian plane 
is of the form $ax+by+c=0$, where $a$, $b$, $c$ are constants. 

Some comments are in order. First note that the text within dollars is typeset in italic 
(actually math italic). Again, even though we did not leave any spaces within ax+by+c=0, 
TgX leaves spaces on either side of the addition signs and the equality sign. On the other 
hand, even if we type $ax + by + c = 0$, the output would be the same: ax + by + c = 0. 
The moral? TgX has its own spacing rules in math mode. 

To see another instance of this, change the last part of the code above to read 
... where $a, b, c$ are constants. 

Saves some typing, does not it? But look at the output. 


The equation representing a straight line in the Cartesian plane is of the form ax + by + c = 0, 
where a, b, c are constants. 

Do you see the difference? There are no spaces after the commas, though we had such 
spaces in the output. So TgX swallows spaces in math mode (you can not save dollars 
that way!). 

Incidentally, dollar signs are TgX way of distinguishing Mathematical text. LTpX 
has other ways also of doing it, using \( ... \) or \begi nfmath} . . . \end{math}. Thus 
either of the inputs shown below also produces the same output as above. 

The equation representing a straight line in the Cartesian plane is of 
the form \(ax+by+c=0\) , where \(a\), \(b\), \(c\) are constants. 

The equation representing a straight line in the Cartesian plane is 
of the form \begi n{math}ax+by+c=0\end{math} , where \begin{math} a 
\end{math}, \begin{math} b \end{math}, \begin{math} c \end{math} are 
constants . 
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viii. Typesetting Mathematics 


Now suppose we want to display the equation in the above output as in 


The equation representing a straight line in the Cartesian plane is of the form 

ax + by + c = 0 

where a, b, c are constants. 


This can be done by changing the input as follows: 

The equation representing a straight line in the Cartesian plane is 
of the form 
$$ 

ax+by+c=0 

$$ 

where $a$, $b$, $c$ are constants. 

Again $$ ... $$ is the TgX way of producing displayed math. ETpX has the constructs 
\[ ... \] or \begin{displaymath} ... \end{di splaymath} also to do this. 


VIII. 1. 1. Superscripts and subscripts 
Look at the text below 


In the seventeenth century, Fermat conjectured that if n > 2 , then there are no integers x, y, z 
for which 

x n + y" = z". 

This was proved in 1994 by Andrew Wiles. 


This is produced by the input 

In the seventeenth century, Fermat conjectured that if $n>2$, then 
there are no integers $x$, $y$, $z$ for which 
$$ 

x“n+y“n=z“n . 

$$ 

This was proved in 1994 by Andrew Wiles. 


This shows that superscripts (mathematicians call them exponents) are produced by the 
‘ symbol. If the superscript is more than one character long, we must be careful to group 
these characters properly. Thus to produce 


It is easily seen that (x'") n = x mn . 


we must type 

It is easily seen that $(x'm)“n=x~{mn}$. 


in the output. 

We can have superscripts of superscripts (and mathematicians do need them). For 
example, 


Instead of $x‘{mn}$, if we type $x"mn$ we end up with x m n instead of the intended 


Numbers of the form 2 2 " + 1 , where n is a natural number, are called Fermat numbers. 


is produced by 
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Numbers of the form $2“{2~n}+l$, where $n$ is a natural number, are 
called Fermat numbers. 

Note the grouping of superscripts. (What happens if you type $2“2“n+l$ or ${2"2}“n$?) 

Now let us see how subscripts (mathematicians call them subscripts) are produced. 
To get 


The sequence (x„) defined by 

Xi = 1, * 2 = T x„ = + x„_ 2 (n > 2) 

is called the Fibonacci sequence. 


we must type 

The sequence $(x_n)$ defined by 
$$ 

x_l=l,\quad x_2=l,\quad x_n=x_{n-l}+x_{n-2}\;\; (n>2) 

$$ 

is called the Fibonacci sequence. 

Thus subscripts are produced by the _ character. Note how we insert spaces by the \quad 
command. (The command \; in math mode produces what is known as a “thickspace”.) 
Subscripts of subscripts can be produced as in the case of superscripts (with appropriate 
grouping). 

We can also have superscripts and subscripts together. Thus 


If the sequence (x„) converges to n, then the sequence ( x 2 ) converges to a 2 
is produced by 

If the sequence $(x_n)$ converges to $a$, then the sequence 
$(x_n“2)$ converges to $a~2$ 

Again, we must be careful about the grouping (or the lack of it) when typesetting 
superscripts and subscripts together. The following inputs and the corresponding outputs 
make the point. 

$$ 

x_nTn\qquad x"n_m\qquad {x_m}~n\qquad {x“n}_m 
$$ 


v " 

■^m m 

(This has to do with the way TgX works, producing “boxes” to fit the output characters. 
The box for x” is like while the box for x m n is ta"j. 

VIII. 1 . 2 . Roots 

Square roots are produced by the \sqrt argument. Thus $\sqrt{2}$ produces V2. This 
command has an optional argument to produce other roots. Thus 

Which is greater yj 5 or ^4? 


is produced by 
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viii. Typesetting Mathematics 


Which is greater $\sqrt [4] {5}$ or $\sqrt [5] {4}$? 


The horizontal line above the root (called vinculum by mathematicians of yore) elon- 
gates to accommodate the enclosed text. For example, $\sqrt{x+y}$ produces yjx + y. 
Also, you can produce nested roots as in 



by typing 

The sequence 
$$ 

2\sqrt{2}\, ,\quad 2'2\sqrt{2-\sqrt{2}}\, Aquad 2“3 
\sqrt{2-\sqrt{2+\sqrt{2}}}\, Aquad 2~4\sqrt{2- 
\sqrt{2+\sqrt{2+\sqrt{2+\sqrt{2}}}}}\, A AT dots 

$$ 

converge to $\pi$. 

The \1 dots command above produces . . ., the three dots indicating indefinite contin- 
uation, called ellipsis (more about them later). The command \, produces a “thinspace” 
(as opposed to a thickspace produced by \; , seen earlier). Why all this thin and thick 
spaces in the above input? Remove them and see the difference. (A tastefully applied 
thinspace is what makes a mathematical expression typeset in TpX really beautiful.) 

The symbol n in the output produced by $\pi$ maybe familiar from high school 
mathematics. It is a Greek letter named “pi”. Mathematicians often use letters of the 
Greek alphabet ((which even otherwise is Greek to many) and a multitude of other sym- 
bols in their work. A list of available symbols in ETeX is given at the end of this chapter. 

VIII. i. 3. Mathematical symbols 

In the list at the end of this chapter, note that certain symbols are marked to be not avail- 
able in native ETeX, but only in certain packages. We will discuss some such packages 
later. Another thing about the list is that they are categorized into classes such as “Bi- 
nary Relations”, “Operators”, “Functions” and so on. This is not merely a matter of 
convenience. 

We have noted that TeX leaves some additional spaces around “binary operators” 
such as + and -. The same is true for any symbol classified as a binary operator. For 
example, consider the following 

For real numbers x and y, define an operation o by 

xo y = x + y — xy 

This operation is associative. 

From the list of symbols, we see that o is produced by \ci rc and this is classified as a 
binary operator, so that we can produce this by 

For real numbers $x$ and $y$, define an operation $\circ$ by 
$$ 
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x\ci re y = x+y-xy 
$$ 

This operation is associative. 


Note the spaces surrounding the o symbol in the output. On the other hand suppose you 
want 

For real numbers x and y, define an operation □ by 

x □ y = x 2 + y 2 


The list of symbols show that the symbol □ is produced by \Box but that it is avail- 
able only in the package latexsym or amssymb. So if we load one of these using the 
\usepackage command and then type 

For real numbers $x$ and $y$, define an operation $\Box$ by 
$$ 

x\Box y = x“2+y~2 
$$ 

you will only get 


For real numbers x and y, define an operation □ by 

xuy = x 2 + y 2 


Notice the difference? There are no spaces around □; this is because, this symbol is 
not by default defined as a binary operator. (Note that it is classified under “Miscel- 
laneous”.) But ive can ask TgX to consider this symbol as a binary operator by the 
command \mathbi n before \Box as in 

For real numbers $x$ and $y$, define an operation $\Box$ by 
$$ 

x\mathbi n\Box y=x“2+y"2 
$$ 


and this will produce the output shown first. 

This holds for “Relations” also. TgX leaves some space around “Relation” symbols 
and we can instruct TgX to consider any symbol as a relation by the command \mathrel. 
Thus we can produce 


Define the relation p on the set of real numbers by x p y iff x — y is a rational number, 
by typing 

Define the relation $\rho$ on the set of real numbers by 
$x\mathrel\rho y$ iff $x-y$ is a rational number. 

(See what happens if you remove the \mathrel command.) 

viii. 2. Custom commands 

We have seen that DTeX produces mathematics (and many other things as well) by means 
of “commands”. The interesting thing is that we can build our own commands using 
the ones available. For example, suppose that t the expression (x\,X2, ■ ■ ■ ,x n ) occurs 
frequently in a document. If we now write 
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\newcommand {\vect} { (x_l , x_2 , \dots , x_n) } 

Then we can type $\vect$ anywhere after wards to produce (xi,X2, ■ ■ -,x„) as in 
We often write $x$ to denote the vector $\vect$. 

to get 

We often write x to denote the vector (x x , x 2 ,...,x n ). 

(By the way, the best place to keep such “newcommands” is the preamble, so that you 
can use them anywhere in the document. Also, it will be easier to change the commands, 
if the need arises). 

OK, we can now produce (x\,X2, ■ ■ ■ ,x„ ) with $\vect$, but how about {y\,y2, ■ ■ - ,yn) 
or (zi,Z2, . . . ,z„)? Do we have to define newcommands for each of these? Not at all. We 
can also define commands with variable arguments also. Thus if we change our definition 
of \vect to 

\newcommand{\vect} [1] {(#1_1,#1_2 ,\dots ,#l_n)} 

Then we can use $\vect{x}$ to produce {x\,X2, ■ ■ ■ ,x n ) and $\vect{a}$ to produce 
- and so on. 

The form of this definition calls for some comments. The [1] in the \newcommand 
above indicates that the command is to have one (variable) argument. What about the 
#1? Before producing the output, each occurrence of #1 will be replaced by the (single) 
argument we supply to \vect in the input. For example, the input $\vect{a}$ will be 
changed to $(a_l,a_2 ,\dots,a_n)$ at some stage of the compilation. 

We can also define commands with more than one argument (the maximum number 
is 9). Thus for example, if the document contains not only (xi,X2, . . . ,x„), {y\, 1/2, • ■ ■ , J/«) 
and so on, but (xi,X2, . . . ,x m ), (t/i, 1/2, • • • / J/p) also, then we can change our definition of 
\vect to 

\newcommand{\vect} [2] {(#1_1,#1_2 ,\dotsc,#l_#2)} 

so that we can use $\vect{x}{n}$ to produce (xi,X2, . . . ,x„) and $\vect{a}{p}$ to pro- 
duce ( Cl\ , Cl2r * • ■ / Up). 


VIII. 3. More ON MATHEMATICS 

There are some many other features of typesetting math in DTgX, but these have better 
implementations in the package amsmath which has some additional features as well. So, 
for the rest of the chapter the discussion will be with reference to this package and some 
allied ones. Thus all discussion below is under the assumption that the package amsmath 
has been loaded with the command \usepackage{amsmath}. 

VIII. 3. 1. Single equations 

In addition to the DTeX commands for displaying math as discussed earlier, the ams- 
math also provides the \begin{equation*} . . . \end{equation*} construct. Thus with 
this package loaded, the output 


The equation representing a straight line in the Cartesian plane is of the form 

ax + by + c = 0 

where a, b, c are constants, 
can also be produced by 
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The equation representing a straight line in the Cartesian plane is 
of the form 
\begi n{equati on*} 
ax+by+c=0 
\end{equati on*} 

where $a$, $b$, $c$ are constants. 

Why the * after equation? Suppose we try it without the * as 

The equation representing a straight line in the Cartesian plane is 
of the form 
\begi n{equati on} 
ax+by+c=0 
\end{equati on} 

where $a$, $b$, $c$ are constants, 
we get 

The equation representing a straight line in the Cartesian plane is of the form 
(VIII. 1 ) ax + by + c = 0 

where a, b, c are constants. 

This provides the equation with a number. We will discuss equation numbering in some 
more detail later on. For the time being, we just note that for any environment name 
with a star we discuss here, the unstarred version provides the output with numbers. 

Ordinary text can be inserted inside an equation using the \text command. Thus 
we can get 

Thus for all real numbers x we have 

x < |x| and x > |x| 

and so 

x < |x| for all x in R. 

from 

Thus for all real numbers $x$ we have 
\begi nfequati on*} 

x\l e | x | \quad\text{and}\quad x\ge | x | 

\end{equati on*} 
and so 

\begi nfequati on*} 

x\l e | x | \quad\text{for all $x$ in $R$}. 

\end{equati on*} 

Note the use of dollar signs in the second \text above to produce mathematical 
symbols within \text. 

Sometimes a single equation maybe too long to fit into one line (or sometimes even 
two lines). Look at the one below: 


(a + b + c + d + ef = a 2 + b 2 + c 2 + d 2 + e 2 

+ lab + lac + lad + lac + Ibc + Ibd + Ibc + led + Ice + Idc 
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viii. Typesetting Mathematics 


This is produced by the environment multline* (note the spelling carefully — it is not 
mu1t[T]line), as shown below. 

\begi n{multl i ne*} 

(a+b+c+d+e) “2=a“2+b“2+c“2+d“2+e~2\\ 

+2ab+2ac+2ad+2ae+2bc+2bd+2be+2cd+2ce+2de 
\end{mul tl i ne*} 

mul tl i ne can be used for equations requiring more than two lines, but without tweaking, 
the results are not very satisfactory. For example, the input 
\begi n{multl i ne*} 

(a+b+c+d+e+f) “2=a“2+b“2+c~2+d~2+e~2+f "2\\ 

+2ab+2ac+2ad+2ae+2af\\ 

+2bc+2bd+2be+2bf\\ 

+2cd+2ce+2cf\\ 

+2de+2df\\ 

+2ef 

\end{mul tl i ne*} 
produces 


(a + b + c + d + e + f) 2 = a 2 + b 2 + c 2 + d 1 + e 2 + f 1 

+ 2cib + 2cic + 2 (id + 2ne + 2 ci f 
+ 2 be + 2 bd + 2be + 2b f 
+ led + Ice + 2c f 
+ 2 de + 2d f 

+ 2 ef 

By default, the multi i ne environment places the first line flush left, the last line flush right 
(except for some indentation) and the lines in between, centered within the display. 

A better way to typeset the above multiline (not multline) equation is as follows. 

(a + b + c + d + e + f) 2 = a 2 + b 2 + c 2 + d 2 + e 2 + f 2 

+ 2cib + 2cic + 2 (id + 2 ne + 2 ci f 
+ 2 be + 2lni + 2 be + 2b f 
+ 2 cd + 2 ce + 2c f 
+ 2 de + 2d f 
+ 2 ef 

This is done using the split environment as shown below. 

\begi nfequati on*} 

\begi n{spl i t} 

(a+b+c+d+e+f) “2 & = a“2+b“2+c“2+d“2+e“2+f “2\\ 

&\quad +2ab+2ac+2ad+2ae+2af\\ 

&\quad +2bc+2bd+2be+2bf\\ 

&\quad +2cd+2ce+2cf\\ 

&\quad +2de+2df\\ 

&\quad +2ef 

\end{spl i t} 

\end{equati on*} 
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Some comments seems to be in order. First note that the split environment cannot 
be used independently, but only inside some equation structure such as equation (and 
others we will soon see). Unlike multline, the split environment provides for alignment 
among the “split” lines (using the & character, as in tabular). Thus in the above example, 
all the + signs are aligned and these in turn are aligned with a point a \quad to the right 
of the = sign. It is also useful when the equation contains multiple equalities as in 


( 1 a + b ) 2 = (a + b)(a + b) 

= a 2 + ab + ba + b 2 
= a 2 + lab + b 2 

which is produced by 
\begi n{equati on*} 

\begi n{spl i t} 

(a+b)~2 & = (a+b)(a+b)\\ 

& = a~2+ab+ba+b~2\\ 

& = a~2+2ab+b~2 
\end{spl i t} 

\end{equati on*} 

VIII. 3. 2. Groups of equations 

A group of displayed equations can be typeset in a single go using the gather environ- 
ment. For example, 


(a, b ) + (c, d) = (a + c,b + d) 

(a, b)(c, d) = ( ac - bd, ad + be) 

can be produced by 
\begi n{gather*} 

(a,b)+(c,d)=(a+c,b+d)\\ 

(a, b) (c , d)=(ac-bd , ad+bc) 

\end{gather*} 

Now when several equations are to be considered one unit, the logically correct way 
of typesetting them is with some alignment (and it is perhaps easier on the eye too). For 
example, 

Thus x, y and z satisfy the equations 

x + y — z = 1 
x - y + z = 1 

This is obtained by using the align* environment as shown below 
Thus $x$, $y$ and $z$ satisfy the equations 
\begi n{al i gn*} 
x+y-z & = 1\\ 
x-y+z & = 1 
\end{al i gn*} 
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We can add a short piece of text between the equations, without disturbing the alignment, 
using the \i ntertext command. For example, the output 

Thus x, y and 2 satisfy the equations 

x + y - z = 1 
x — y + 2 = 1 

and by hypothesis 

x + y + 2 = 1 

is produced by 

Thus $x$, $y$ and $z$ satisfy the equations 
\begi n{al i gn*} 
x+y-z & = 1\\ 
x-y+z & = 1\\ 

\i ntertextfand by hypothesis} 
x+y+z & =1 
\end{ai i gn*} 


We can also set multiple ‘columns’ of aligned equations side by side as in 


Compare the following sets of equations 


cos 2 x + sin 2 x = 1 

cosh 2 x - sinh 2 x = 1 

cos 2 x - sin 2 x = cos 2x 

cosh 2 x + sinh 2 x = cosh 2x 


All that it needs are extra &’s to separate the columns as can be sen from the input 
Compare the following sets of equations 
\begi n{al i gn*} 

\cos“2x+\si n“2x & = 1 & \cosh"2x-\si nh~2x & = 1\\ 

\cos“2x-\si n“2x & = \cos 2x & \cosh~2x+\si nh~2x & = \cosh 2x 
\end{al i gn*} 

We can also adjust the horizontal space between the equation columns. For example, 
Compare the sets of equations 
\begi n{al i gn*} 

\cos“2x+\si n“2x & = 1 &\qquad \cosh“2x-\si nh~2x & = 1\\ 

\cos“2x-\si n“2x & = \cos 2x &\qquad \cosh“2x+\si nh“2x & = \cosh 2x 
\end{al i gn*} 


gives 


Compare the sets of equations 


cos 2 x + sin 2 x = 1 

cosh 2 x - sinh 2 x = 1 

cos 2 x - sin 2 x = cos 2x 

cosh 2 x + sinh 2 x = cosh 2x 


Perhaps a nicer way of typesetting the above is 
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Compare the following sets of equations 

cos 2 x + sin 2 x = 1 cosh 2 x - sinh 2 x = 1 

, and 

cos x - sin x = cos 2x cosh x + sinh x = cosh 2x 

This cannot be produced by the equation structures discussed so far, because any of these 
environments takes up the entire width of the text for its display, so that we cannot put 
anything else on the same line. So amsmath provides variants gathered, aligned and 
al i gnedat which take up only the actual width of the contents for their display. Thus the 
above example is produced by the input 

Compare the following sets of equations 
\begi nfequation*} 

\begi n{al i gned} 

\cos“2x+si n“2x & = 1\\ 

\cos~2x-\si n~2x & = \cos 2x 
\end{al i gned} 

\qquad\text{and}\qquad 
\begi n{al i gned} 

\cosh"2x-\si nh“2x & = 1\\ 

\cosh“2x+\si nh“2x & = \cosh 2x 
\end{al i gned} 

\end{equati on*} 


Another often recurring structure in mathematics is a display like this 


|x| 


jx if x > 0 
1 -x if x < 0 


There is a special environment cases in amsmath to take care of these. The above exam- 
ple is in fact produced by 
\begi nfequati on*} 

I x | = 

\begi nfcases} 

x & \text{if $x\ge 0$}\\ 

-x & \text{if $x\le 0$} 

\end{cases} 

\end{equati on*} 


VIII. 3. 3. Numbered equations 

We have mentioned that each of the the ‘starred’ equation environments has a corre- 
sponding unstarred version, which also produces numbers for their displays. Thus our 
very first example of displayed equations with equation instead of equation* as in 
The equation representing a straight line in the Cartesian plane is 
of the form 
\begi nfequati on} 
ax+by+c=0 
\end{equati on} 

where $a$, $b$, $c$ are constants. 
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produces 

The equation representing a straight line in the Cartesian plane is of the form 
(VIII.2) ax + by + c = 0 

where a, b, c are constants. 


Why VIII. 2 for the equation number? Well, this is Equation number 2 of Chap- 
ter VIII, isn’t it? If you want the section number also in the equation number, just give 
the command 


\numberwi thi nfequati on}{secti on} 

We can also override the number ETeX produces with one of our own design with the 
\tag command as in 

The equation representing a straight line in the Cartesian plane is 
of the form 
\begi nfequation} 
ax+by+c= 0 \tag{L} 

\end{equati on} 

where $a$, $b$, $c$ are constants, 
which gives 


The equation representing a straight line in the Cartesian plane is of the form 
(L) ax + by + c = 0 

where a, b, c are constants. 


There is also a \tag* command which typesets the equation label without parentheses. 

What about numbering alignment structures? Except for split and aligned, all 
other alignment structures have unstarred forms which attach numbers to each aligned 
equation. For example, 

\begi n{al i gn} 
x+y-z & = 1\\ 
x-y+z & = 1 
\end{al i gn} 


gives 


(VIII.3) 

x + y — z = 1 

(VIII.4) 

x — y + z = 1 


Here is also, you can give a label of your own to any of the equations with the \tag 
command. Be careful to give the \tag before the end of line character \\ though. (See 
what happens if you give a \tag command after a \\.) You can also suppress the label for 
any equation with the \notag command. These are illustrated in the sample input below: 
Thus $x$, $y$ and $z$ satisfy the equations 
\begi n{al i gn*} 





viii. 4. Mathematics miscellany 


89 


x+y-z & = l\ntag\\ 
x-y+z & = l\notag\\ 

\i ntertext{and by hypothesis} 
x+y+z & =l\tag{H} 

\end{al i gn*} 

which gives the following output 
Thus x, y and z satisfy the equations 


x + y — z = 1 
x - y + z = 1 


and by hypothesis 

(H) x + y + z = 1 


What about split and aligned? As we have seen, these can be used only within 
some other equation structure. The numbering or the lack of it is determined by this 
parent structure. Thus 

\begi n{equati on} 

\begi n{spl i t} 

(a+b)“2 & = (a+b)(a+b)\\ 

& = a“2+ab+ba+b~2\\ 

& = a“2+2ab+b“2 
\end{spl i t} 

\end{equati on} 


gives 



(1 a + b ) 2 = (a + b)(a + b) 

(VIII.5) 

= a 2 + ab + ba + b 2 


= a 2 + lab + b 2 


viii. 4. Mathematics miscellany 

There are more things Mathematics than just equations. Let us look at how LTgX and in 
particular, the amsmath package deals with them. 


VIII. 4. 1. Matrices 

Matrices are by definition numbers or mathematical expressions arranged in rows and 
columns. The amsmath has several environments for producing such arrays. For example 
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The system of equations 


x + y — z = 1 
x - y + z = 1 
x + y + z = 1 


can be written in matrix terms as 


1 

1 

-1' 

'x' 


T 

1 

-1 

1 

y 

= 

1 

1 

1 

1 

Z, 


UJ 


Here, the matrix 




u 


1 

-1 

1 



is invertible. 


is produced by 

The system of equations 
\begi n{ai i gn*} 
x+y-z & = 1\\ 
x-y+z & = 1\\ 
x+y+z & = 1 
\end{ai i gn*} 

can be written in matrix terms as 
\begi nfequati on*} 

\begi nfpmatri x} 

1 & 1 & - 1 \\ 

1 & -1 & 1\\ 

1 & 1 & 1 
\end{pmatri x} 

\begi nfpmatri x} 
x\\ 
y\\ 

z 

\end{pmatri x} 


\begi nfpmatri x} 

1 \\ 

1\\ 

1 

\end{pmatri x} . 

\end{equati on*} 

Here, the matrix 
$\begi nfpmatri x} 

1 & 1 & - 1 \\ 

1 & -1 & 1\\ 

1 & 1 & 1 
\end{pmatri x}$ 
is invertible. 

Note that the environment pmatrix can be used within in-text mathematics or in 
displayed math. Why the p? There is indeed an environment matrix (without a p) but it 
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produces an array without the enclosing parentheses (try it). If you want the array to be 
enclosed within square brackets, use bmatrix instead of pmatrix. Thus 


Some mathematicians write matrices within parentheses as in 

\c 


b 

d 


while others prefer square 


brackets as in 


a 

c 


b 

d 


is produced by 

Some mathematicians write matrices within parentheses as in 


\begi n{pmatri x} 
a & b\\ 
c & d 

\end{pmatri x} 


while others prefer square brackets as in 
$ 

\begi nfbmatri x} 
a & b\\ 
c & d 

\end{bmatri x} 

$ 


There is also a vmatrix environment, which is usually used for determinants as in 


The determinant 


a b 
c d\ 


is defined by 


a b 
c d 


= ad -be 


which is obtained from the input 
The determinant 


\begi nfvmatri x} 
a & b\\ 
c & d 

\end{vmatri x} 

$ 

i s def i ned by 
\begi n{equati on*} 

\begi n{vmatri x} 
a & b\\ 
c & d 

\end{vmatri x} 

=ad -be 

\end{equati on*} 

There is a variant Vmatrix which encloses the array in double lines. Finally, we have a 
Bmatrix environment which produces an array enclosed within braces { }. 
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A row of dots in a matrix can be produced by the command \hdotsfour. it should 
be used with an argument specifying the number of columns to be spanned. For example, 
to get 


A general m x n matrix is of the form 


('flu 

fll2 

. d\ n 

fl 2 i 

fl 22 

. U2n 

Mml 

a m2 

• Q-mn/ 


we type 

A general $m\times n$ matrix is of the form 
\begi nfequati on*} 

\begi nfpmatri x} 

a_{ll} & a_{12} & \dots & a_{ln}\\ 
a_{21} & a_{22} & \dots & a_{2n}\\ 
\hdotsfor{4}\\ 

a_{ml} & a_{m2} & \dots & a_{mn} 
\end{pmatri x} 

\end{equati on*} 


The command \hdotsfor has also an optional argument to specify the spacing of dots. 
Thus in the above example, if we use \hdotsfor[2] {4}, then the space between the dots 
is doubled as in 


A general m x n matrix is of the form 


('flu 

fll2 

• Ain 

1 

a 2 2 

a 2n 

Mini 

Clm2 

• Q-mnj 


VIII. 4. 2. Dots 

In the above example, we used the command \dots to produce a row of three dots. This 
can be used in other contexts also. For example, 

Consider a finite sequence $X_l,X_2,\dots$, its sum $X_l+X_2+\dots$ 
and product $X_lX_2\dots$ . 

gives 

Consider a finite sequence X lr X 2 , . . . , its sum X\ + X 2 + . . . and product XiX 2 

Here the dots in all the three contexts are along the “baseline” of the text. Isn’t it better 
to typeset this as 

Consider a finite sequence X lr X 2/ . . . , its sum X 2 + X 2 + ■ ■ • and product X 2 X 2 ■ ■ • . 

with raised dots for addition and multiplication? The above text is typeset by the input 
Consider a finite sequence $X_1,X_2 ,\dotsc$ , its sum $X_l+X_2+\dotsb$ 
and product $X_lX_2\dotsm$ . 
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Here \dotsc stands for dots to be used with commas, \dotsb for dots with binary 
operations (or relations) and \dotsm for multiplication dots. There is also a \dotsi for 
dots with integrals as in 



VIII. 4. 3. Delimiters 


How do we produce something like 



a h g 

I “ h g\ 

Since 

hb f 

= 0, the matrix \ h b / is not invertible. 


g f C 

\gfc) 


Here the ‘small’ in-text matrices are produced by the environment small matrix. This 

environment does not provide the enclosing delimiters ( ) or which we must supply 

as in 

$ 

\1 eft | \begi n{smal 1 matri x} 
a & h & g\\ 
h & b & f\\ 
g & f & c 

\end{smal 1 matri x}\ri ght | 

=0 

$, 

the matrix 

$ 

\left(\begi n{ small matri x} 
a & h & g\\ 
h & b & f\\ 
g & f & c 

\end{smal 1 matri x}\ri ght) 

$ 

is not invertible. 

Why the \1 eft | . . .\right | and \1 eft{ . . .\ri ght? These commands \1 eft and \ri ght 
enlarge the delimiter following them to the size of the enclosed material. To see their ef- 
fect, try typesetting the above example without these commands. The list of symbols at 
the end of the chapter gives a list of delimiters that are available off the shelf. 

One interesting point about the \left and \right pair is that, though every \left 
should be matched to a \ri ght, the delimiters to which they apply need not match. In par- 
ticular we can produce a single large delimiter produced by \1 eft or \ri ght by matching 
it with a matching command followed by a period. For example, 


> Cauchy-Riemann Equations 
u y = -v x ) 


is produced by 
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\begi n{equati on*} 

\left. 

\begi n{al i gned} 
u_x & = v_y\\ 
u_y & = -v_x 
\end{al i gned} 

\right\} 

\quad\text {Cauchy- Ri emann Equations} 

\end{equati on*} 

There are instances where the delimiters produced by \1 eft and \ri ght are too small 
or too large. For example, 

\begi n{equati on*} 

(x+y) ~2-(x-y) “2=\left((x+y) + (x-y)\right)\left((x+y)-(x-y)\right)=4xy 
\end{equati on*} 

gives 

(X + yf -(x- yf = ((x + y) + (x - y)) ((x + y) - (x - y)) = 4 xy 

where the parentheses are all of the same size. But it may be better to make the outer 
ones a little larger to make the nesting visually apparent, as in 

(x + y) 2 - (x - yf = ((x + y) + (x - y))((x + y) - (x - y)) = 4xy 

This is produced using the commands \bigl and \bigr before the outer parentheses as 
shown below: 

\begi n{equati on*} 

(x+y) “2-(x-y) “2=\bi gl ((x+y)+(x-y)\bi gr)\bi gl ((x+y)-(x-y)\bigr)=4xy 
\end{equati on*} 

Apart from \bigl and \bigr there are \Bigl, \biggl and \Biggl commands (and 
their r counterparts) which (in order) produce delimiters of increasing size. (Experiment 
with them to get a feel for their sizes.) 

As another example, look at 

For n-tuples of complex numbers (x lA x 2 , . . . , x„) and (yi, y 2/ ■ ■ ■ , y„ ) of complex numbers 

/ n / n / n ' 

V k=l k= 1 / \k=l , 

which is produced by 

For $n$-tuples of complex numbers $(x_l,x_2,\dotsc,x_n)$ and 
$(y_l,y_2,\dotsc,y_n)$ of complex numbers 
\begi nfequati on*} 

\1 ef t (\sum_{k=l} " n | x_ky_k | \ri ght) “ 2\1 e 

\1 eft(\sum_{k=l} “{n} | x_k | \ri ght)\l eft (\sum_{k=l} “ {n} | y_k | \ri ght) 
\end{equati on*} 

Does not the output below look better? 
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For w-tuples of complex numbers (pci, x 2 ,..., x n ) and (i/i, y 2 ,...,y n ) of complex numbers 

(X, - (X, |Xi| )(Z, lyjti) 

' k = \ ' v fc=l /v t= 1 ' 


This one is produced by 

For $n$-tuples of complex numbers $(x_l,x_2,\dotsc,x_n)$ and 
$(y_l,y_2,\dotsc,y_n)$ of complex numbers 
\begi nfequati on*} 

\bi ggl (\sum_{k=l}"n | x_ky_k | \bi ggr) “2\1 e 

\bi ggl (\sum_{k=l}“{n} | x_k | \bi ggr)\bi ggl (\sum_{k=l}~{n} | y_k | \biggr) 
\end{equati on*} 

Here the trouble is that the delimiters produced by \left and \right are a bit too large. 


VIII. 4. 4. Putting one over another 


Look at the following text 


From the binomial theorem, it easily follows that if n is an even number, then 


1 - 






We have fractions like ^ and binomial coefficients like ff) here and the common feature 
of both is that they have one mathematical expression over another. 

Fractions are produced by the \f rac command which takes two arguments, the nu- 
merator followed by the denominator and the binomial coefficients are produced by the 
\bi nom command which also takes two arguments, the ‘top’ expression followed by the 
‘bottom’ one. Thus the the input for the above example is 

From the binomial theorem, it easily follows that if $n$ is an even 
number, then 
\begi nfequati on*} 

l-\bi nom{n}{l}\f rac{l}{2}+\bi nom{n}{2}\f rac{l}{2~2}-\dotsb 
-\bi nom{n}{n-l}\f rac{l}{2“{n-l}}=0 
\end{equati on*} 


You can see from the first paragraph above that the size of the outputs of \frac 
and \bi nom are smaller in text than in display. This default behavior has to be modified 
sometimes for nicer looking output. For example, consider the following output 

Since (x„) converges to 0, there exists a positive integer p such that 

1 

|x„| < - for all n > p 

Would not it be nicer to make the fraction smaller and typeset this as 

Since ( x n ) converges to 0, there exists a positive integer p such that 

\x n \ < \ for all n > p 


The second output is produced by the input 
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Since $(x_n)$ converges to $0$, there exists a positive integer $p$ 

such that 

\begi n{equati on*} 

I x_n | <\tf rac{l}{2}\quad\text{for all $n\ge p$} 

\end{equati on*} 

Note the use of the command \tf rac to produce a smaller fraction. (The first output is 
produced by the usual \f rac command.) 

There is also command \df rac to produce a display style (larger size) fraction in text. 
Thus the sentence after the first example in this (sub) section can be typeset as 

1 

We have fractions like - — - and ... 

2«-i 

by the input 

We have fractions like $\df rac{l}{2~{n-l}}$ and ... 

As can be guessed, the original output was produced by \frac. Similarly, there 
are commands \dbinom (to produce display style binomial coefficients) and \tbinom (to 
produce text style binomial coefficients). 

There is also a \genf rac command which can be used to produce custom fractions. 
To use it, we will have to specify six things 

1. The left delimiter to be used — note that { must be specified as \{ 

2. The right delimiter — again, } to be specified as \} 

3. The thickness of the horizontal line between the top expression and the bottom ex- 
pression. If it is not specified, then it defaults to the ‘normal’ thickness. If it is set as 
Opt then there will be no such line at all in the output. 

4. The size of the output — this is specified as an integer o, 1, 2 or 3, greater values cor- 
responding to smaller sizes. (Technically these values correspond to \displaystyle, 
\textstyle, \scri ptstyle and \scri ptscri ptstyle.) 

5. The top expression 

6. The bottom expression 

Thus instead of \tf rac{l}{2} we can also use \genf rac{}{}{}{l}{l}{2} and instead 
of \dbi nom{n}{r}, we can also use \genf rac{(}{)}{0pt}{0}{l}{2} (but there is hardly 
any reason for doing so). More seriously, suppose we want to produce {^} and ['^] as in 

The Christoffel symbol {)(} of the second kind is related to the Christoffel symbol of the first 
kind by the equation 



This can be done by the input 

The Christoffel symbol {)(} of the second kind is related to the Christoffel symbol [^j of the first 
kind by the equation 



If such expressions are frequent in the document, it would be better to define ‘newcom- 
mands’ for them and use them instead of \genf rac every time as in the following input 
(which produces the same output as above). 
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\newcommand{\chsfk} [2] {\genf rac{ [}{] }{0pt}{}{#l}{#2}} 

\newcommand{\chssk} [2] {\genf rac{\{}{\}}{0pt}{}{#l}{#2}} 

The Christoffel symbol $\genf rac{\{}{\}}{0pt}{}{i j}{l<}$ of the second 
kind is related to the Christoffel symbol $\genf rac{ [}{] }{0pt}{}{i j } { k } $ 
of the first kind by the equation 
\begi n{equati on*} 

\chssk{i j}{k}=g"{kl}\chsfk{i j}{l}+g“{k2}\chsfk{i j}{2} 

\end{equation*} 


While on the topic of fractions, we should also mention the \cf rac command used 
to typeset continued fractions. For example, to get 




simply type 

\begi n{equati on*} 

\f rac{4}{\pi }=l+\cf rac{l“2}{2+ 

\cf rac{3~2}{2+ 

\cf rac{5'2}{2+\dotsb}}} 

\end{equati on*} 


Some mathematicians would like to write the above equation as 


4 _ 1^ 3^ 52 

n~ + 2 + 2 + 2 + ' 

There is no ready-to-use command to produce this, but we can define one as follows 

\newcommand{\cfpl us}{\mathbi n{\genf rac{}{}{Opt}{}{}{+}}} 

\begi n{equati on*} 

\f rac{4}{\pi } 

=l+\f rac{l"2}{2}\cfpl us\f rac{3“2}{2}\cfpl us\f rac{5~2}{2}\cfpl us\dotsb 
\end{equati on*} 


VIII.4.5. Affixing symbols — over or under 

The table at the end of this chapter gives various math mode accents such as $\hat{a}$ 
to produce a and $\dot{a}$ to produce a. But what if one needs a or a ? The commands 

o 

o 

\overset and \underset come to the rescue. Thus $\overset{\ci rc}{a}$ produces a and 
$\underset{\ci rc}{a}$ produces a. 

O 

Basic FTeX provides the commands \overri ghtarrow and \overl eftarrow also to put 
(extensible) arrows over symbols, as can be seen from the table. The amsmath package 
also provides the commands \underri ghtarrow and \underl eftarrow to put (extensible) 
arrows below mathematical expressions. 

Speaking of arrows, amsmath provides the commands \xri ghtarrow and \xl eftarrow 
which produces arrows which can accommodate long texts as superscripts or subscripts. 
Thus we can produce 
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Thus we see that 

0^ a4 B-4 C-> 0 

is a short exact sequence 

from the input 

Thus we see that 
\begi nfequati on*} 

0\xri ghtarrowf} A\xri ghtarrowff} 

B\xri ghtarrow{g} 

C\xrightarrow{} 0 

\end{equati on*} 

is a short exact sequence 

Note how the mandatory arguments of the first and last arrows are left empty to produce 
arrows with no superscripts. These commands also allow an optional argument (to be 
typed inside square brackets), which can be used to produce subscripts. For example 
Thus we get 
\begi nfequati on*} 

0\xri ghtarrowf} A\xri ghtarrow[\text{moni c}] {f} 

B\xri ghtarrow[\text{epi }] {g} 

C\xrightarrow{} 0 

\end{equati on*} 
gives 

Thus we get 

O^A-^B-4C^O 

monic epi 

By the way, would not it be nicer to make the two middle arrows the same width? This 
can be done by changing the command for the third arrow (the one from B) as shown 
below 

Thus we get 
\begi nfequati on*} 

0\xri ghtarrowf} A\xri ghtarrow[\text{moni c}] {f} 

B\xri ghtarrow[\hspace{7pt}\text{epi }\hspace{7pt}] {g} 

C\xri ghtarrow{}0 

\end{equati on*} 

This gives 

Thus we get 

0— > A — > B > C-» 0 

monic epi 

where the lengths of the two arrows are almost the same. There are indeed ways to make 
the lengths exactly the same, but we will talk about it in another chapter. 

Mathematical symbols are also attached as limits to such large operators as sum 
(Lh product (n) set union ( 1J ), set intersection (H) and so on. The limits are input 
as subscripts or superscripts, but their positioning in the output is different in text and 
display. For example, the input 
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Euler not only proved that the series 

$\sum_{n=l}“\infty\f rac{l}{n~2}$ converges, but also that 
\begi n{equati on*} 

\sum_{n=l}“\i nfty\f rac{l}{n~2}=\f rac{\pi ~2}{6} 
\end{equati on*} 

gives the output 

Euler not only proved that the series £,“ =1 \ converges, but also that 



Note that in display, the sum symbol is larger and the limits are put at the bottom and 
top (instead of at the sides, which is usually the case for subscripts and superscripts). If 
you want the same type of symbol (size, limits and all) in text also, simply change the line 

$\sum_{n=l}"\i nfty\f rac{l}{n“2}$ 


to 


$\di spl aystyl e\sum_{n=l}"\i nfty\f rac{l}{n“2}$ 


and you will get 


Euler not only proved that the series 


oo 

y — converges, but also that 

n = 1 



n = 1 


(Note that this also changes the size of the fraction. What would you do to keep it 
small?) On the other hand, to make the displayed operator the same as in the text, add 
the command \textstyle before the \sum within the equation. 

What if you only want to change the position of the limits but not the size of the 
operator in text? Then change the command $\sum_{n=l}“\infty \f rac{l}{n"2}$ to 
$\sum_\l imi ts{n=l}“\i nfty\f rac{l}{n“2}$ and this will produce the output given below. 


Euler not only proved that the series £ ^ converges, but also that 

n-1 



On the other hand, if you want side-set limits in display type \nolimits after the \sum 
within the equation as in 

Euler not only proved that the series 

$\sum_{n=l}“\infty\f rac{l}{n~2}$ converges, but also that 
\begi nfequati on*} 

\sum\nol imi ts_{n=l}“\i nfty\f rac{l}{n~2}=\f rac{\pi “2} {6} 

\end{equati on*} 


which gives 
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Euler not only proved that the series \ converges, but also that 

L eo i ji 2 

n - 1 n 2 6 

All these are true for other operators classified as “Variable-sized symbols”, except 
integrals. Though the integral symbol in display is larger, the position of the limits in 
both text and display is on the side as can be seen from the output below 

Thus lim C dx = f and so by definition, 

X — >00 x z 

f°° sinx , 7i 

dx = — 

Jo X 2 

which is produced by 
Thus 

$\1 im\l imi ts_{x\to\i nfty}\i nt_0“x\f rac{\si n x}{x}\,\mathrm{d}x 
=\f rac{\pi }{2}$ 
and so by definition, 

\begi n{equati on*} 

\i nt_0“\i nfty\f rac{\si n x}{x}\,\mathrm{d}x=\frac{\pi }{2} 

\end{equati on*} 

If you want the limits to be above and below the integral sign, just add the command 
\limits immediately after the \int command. Thus 

Thus 

$\1 im\l imi ts_{x\to\i nfty}\i nt_0“x\f rac{\si n x}{x}\,\mathrm{d}x 
=\f rac{\pi }{2}$ 
and so by definition, 

\begi n{equati on*} 

\i nt\l imits_0“\i nfty\f rac{\si n x}{x}\,\mathrm{d}x=\f rac{\pi }{2} 

\end{equati on*} 



where we have two lines of subscripts for f|? There is a command \substack which will 
do the trick. The above output is obtained from 
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\begi n{equati on*} 

p_k(x)=\prod_{\substack{i=l\\i\ne k}}~n 

\1 eft(\f rac{x-t_i }{t_k-t_i }\ri ght) 

\end{equati on*} 

The amsmath package has also a \si deset command which can be used to put 
symbols at any of the four corners of a large operator. Thus 

$\sideset{_{ll}"{ul}}{_{l r}‘{ur}}\bigcup$ produces 

$\sideset{}{’}\sum$ produces 

viii. 5. New operators 

Mathematical text is usually typeset in italics, and TpX follows this tradition. But certain 
functions in mathematics such as log, sin, lim and so on are traditionally typeset in 
roman. This is implemented in TgX by the use of commands like $\log$, $\sin$, $\lim$ 
and so on. The symbols classified as “Tog-like symbols” in the table at the end of this 
chapter shows such functions which are predefined in TTeX. 

Having read thus far, it may be no surprise to learn that we can define our own 
“operator names” which receive this special typographic treatment. This is done by 
the \Decl areMathOperator command. Thus if the operator cl occurs frequently in the 
document, you can make the declaration 

\DecI areMathOperator{\cl }{cl } 

in the preamble and then type $\cl (A)$ to produce cl(A), for example. 

Note that an operator defined like this accommodates subscripts and superscripts in 
the usual way, that is, at its sides. Thus 

We denote the closure of $A$ in the subspace $Y$ of $X$ by 
$\cl_Y (A) $ 

produces 

We denote the closure of A in the subspace Y of X by cly(A) 

If we want to define a new operator with subscripts and superscripts placed in the “lim- 
its” position below and above, then we should use the starred form of the \Decl areMathOperator 
as shown below 

\Decl areMathOperator*{\esup}{ess\, sup} 

For $f\in L~\infty(R)$, we define 
\begi n{equati on*} 

I I f I I _\i nfty=\esup_{x\i n R} | f (x) | 

\end{equati on*} 


(Note that the declaration must be done in the preamble.) This produces the output 


For / e L“(R), we define 

ll/llco = ess sup |/(x)| 


xeR 


(Why the \, command in the definition?) 
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viii. 6. The many faces of mathematics 

We have noted that most mathematics is typeset in italics typeface and some mathematical 
operators are typeset in an upright fashion. There may be need for additional typefaces 
as in typesetting vectors in boldface. 

ETeX includes several styles to typeset mathematics as shown in the table below 


TYPE STYLE 

COMMAND 

EXAMPLE 

INPUT 

OUTPUT 

italic 

(default) 

\mathit 

$x+y=z$ 

x + y = z 

roman 

\mathrm 

$\math rm{x+y=z} $ 

x + y = z 

bold 

\mathbf 

$\mathbf {x+y=z}$ 

x + y = z 

sans serif 

\mathsf 

$\mathsf {x+y=z}$ 

x + y = z 

typewriter 

\mathtt 

$\mathtt{x+y=z}$ 

x + y = z 

calligraphic 
(upper case only) 

\mathcal 

$\mathcal {X+Y=Z}$ 

x + y = z 


In addition to these, several other math alphabets are available in various packages (some 
of which are shown in the list of symbols at the end of this chapter). 

Note that the command \mathbf produces only roman boldface and not math italic 
boldface. Sometimes you may need boldface math italic, for example to typeset vectors. 
For this, amsmath provides the \boldsymbol command. Thus we can get 

In this case, we define 

a + b = c 

from the input 

In this case, we define 
\begi n{equati on*} 

\bol dsymbol {a}+\bol dsymbol {b}=\bol dsymbol {c} 

\end{equati on*} 

If the document contains several occurrences of such symbols, it is better to make a 
new definition such as 


\newcommand{\vect} [1] {\bol dsymbol {#!}} 


and then use $\vect{a}$ to produce a and $\vect{b}$ to produce b and so on. the 
additional advantage of this approach is that if you change your mind later and want 
vectors to be typeset with arrows above them as a , then all you need is to change the 
\boldsymol part of the definition of \vect to \overri ghtarrow and the change will be 
effected throughout the document. 

Now if we change the input of the above example as 

In this case, we define 
\begi n{equati on*} 

\bol dsymbol {a+b=c} 

\end{equati on*} 


then we get the output 
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Note that now the symbols + and = are also in boldface. Thus \boldsymbol makes bold 
every math symbol in its scope (provided the bold version of that symbol is available in 
the current math font). 

There is another reason for tweaking the math fonts. Recently, the International 
Standards Organization (ISO) has established the recognized typesetting standards in 
mathematics. Some of the points in it are, 

1. Simple variables are represented by italic letters as a, x. 

2. Vectors are written in boldface italic as a, x. 

3. Matrices may appear in sans serif as in A, X. 

4. The special numbers e, i and the differential operator d are written in upright roman. 

Point 1 is the default in LTpX and we have seen how point 2 can be implemented, 
to fulfill Point 4, it is enough if we define something like 

\newcommand{\me}{\mathrm{e}} 

\newcommand{\mi }{\mathrm{i }} 

\newcommand{\di ff}{\mathrm{d}} 

and then use $\me$ for e and $\mi $ for i and $\di ff x$ for dx. 

Point 3 can be implemented using \mathsf but it is a bit difficult (but not impossible) 
if we need them to be in italic also. The solution is to create a new math alphabet, say, 
\mathsfsl by the command 

\Decl areMathAl phabet{\mathsfsl }{OTl}{cmss}{m}{sl } 

(in the preamble) and use it to define a command \matr to typeset matrices in this font by 

\newcommand{\matr} [1] {\ensuremath{\mathsfsl {#1}}} 

so that $\maqtr A$ produces A. 

viii. 7. And that is not all! 

We have only briefly discussed the basic techniques of typesetting mathematics using 
LTeX and some of the features of the amsmath package which helps us in this task. For 
more details on this package see the document amsldoc.dvi which should be available 
with your TgX distribution. If you want to produce really beautiful mathematical doc- 
uments, read the Master — “The TgX Book” by Donald Knuth, especially Chapter 18, 
“Fine Points of Mathematics Typing”. 
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Table Vlll.i: Greek Letters 


a 

\al pha 

e 

\theta 

0 

0 

T 

\tau 

P 

\beta 

$ 

\vartheta 

n 

\pi 

V 

\upsi"lon 

y 

\gamma 

1 

\i ota 

CD 

\varpi 

<P 

\phi 

5 

\de1ta 

K 

\kappa 

P 

\rho 

<P 

\varphi 

e 

\epsilon 

A 

\lambda 

Q 

\varrho 

X 

\chi 

£ 

\varepsilon 

P 

\mu 

0 

\sigma 


\psi 
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e 

\zeta 

V 

\nu 

C 

\varsigma 

CO 

\omega 

n 

\eta 


\xi 





r 

\Gamma 

A 

\Lambda 

L 

\Sigma 

W 

\Psi 

A 

\Delta 


\Xi 

T 

\Upsilon 

Q 

\Omega 

0 

\Theta 

n 

\Pi 

O 

\Phi 






Table VIII.2: 

Binary Operation Symbols 



± 

\pm 

n 

\cap 

0 

\di amond 

® 

\opl us 

+ 

\mp 

u 

\cup 

A 

\bi gtri angl eup 

0 

\omi nus 

X 

\times 

i+j 

\upl us 

V 

\bi gtri angl edown 

0 

\otimes 

-r 

\div 

n 

\sqcap 

< 

\tri angl el eft 

0 

\oslash 

* 

\ast 

u 

\sqcup 

> 

\tri angl eri ght 

O 

\odot 

★ 

\star 

V 

\vee 

<1 

\lhd* 

O 

\bi gci rc 

O 

\ci rc 

A 

\wedge 

> 

\rhd* 

+ 

\dagger 

• 

\bul 1 et 

\ 

\setminus < 

\unlhd* 

t 

\ddagger 


\cdot 

t 

\wr 

> 

\unrhd* 

U 

\amalg 

+ 

+ 

- 

- 






Not predefined in ETgX 2 £ . Use one of the packages latexsym, amsfonts or amssymb. 

Table VIII.3: Relation Symbols 


< 

\1 eq 

> 

\geq 

= 

\equi v 

h 

\model s 

< 

\prec 

> 

\succ 

~ 

\sim 

± 

\perp 

< 

\preceq 

> 

\succeq 

- 

\simeq 

1 

\mid 

<sc 

\11 

» 

\gg 


\asymp 

|| 

\paral 1 el 

c 

\subset 

D 

\supset 


\approx 

X 

\bowti e 

c 

\subseteq 

D 

\supseteq 


\cong 

X 

\Joi n* 

C 

\sqsubset* 

□ 

\sqsupset* 

* 

\neq 


\smi 1 e 

c 

\sqsubseteq 

□ 

\sqsupseteq 

= 

\doteq 


\f rown 

e 

Yin 


\ni 

oc 

\propto 

= 

= 

h 

\vdash 

H 

\dashv 

< 

< 

> 

> 


* Not predefined in UTeX 2 £ . Use one of the packages latexsym, amsfonts or amssymb. 


Table VIII.4: Punctuation Symbols 


\colon . \ldotp • \cdotp 


Table VIII.5: Arrow Symbols 


<— \leftarrow 
<= \Leftarrow 
— » \rightarrow 

=> \Rightarrow 

\leftrightarrow 
\l_eftrightarrow 
1 — > \mapsto 


\longleftarrow ; 
\Longleftarrow ff 
\longrightarrow X 
\Longrightarrow If 
\longleftrightarrow X 
\Longleftrightarrow ff 
\longmapsto 


\uparrow 

\Uparrow 

\downarrow 

\Downarrow 

\updownarrow 

\Updownarrow 

\nearrow 
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\hookl eftarrow 

\hookri ghtarrow 

\ 

\searrow 

\1 eftharpoonup — x 

\ri ghtharpoonup 

/ 

\swarrow 

■<— \1 eftharpoondown — r 

\ri ghtharpoondown 

\ 

\nwarrow 

^ \ri ghtl eftharpoons 

\leadsto* 




* Not predefined in LJTpX z £ . Use one of the packages latexsym, amsfonts or amssymb. 
Table VIII.6: Miscellaneous Symbols 



\ldots 


\cdots 


\vdots 


\ddots 

K 

\al eph 

/ 

\prime 

V 

\foral 1 

00 

\infty 

h 

\hbar 

0 

\emptyset 

3 

\exi sts 

□ 

\Box* 

1 

\imath 

V 

\nabl a 

— 1 

\neg 

0 

\Di amond* 

J 

\jmath 

V 

\surd 

b 

\fl at 

A 

\tri angl e 

£ 

\el 1 

T 

\top 

b 

\natural 

* 

\clubsuit 

P 

\wp 

± 

\bot 

tt 

\sharp 

❖ 

\di amondsui t 

% 

\Re 

|| 

\l 

\ 

\backsl ash 


\heartsuit 

3 

O 

\Im 

\mho* 

Z 

\angl e 

d 

1 

\parti at 
1 

* 

\spadesuit 


* Not predefined in DTeX z £ . Use one of the packages latexsym, amsfonts or amssymb. 
Table VIII.7: Variable-sized Symbols 


\sum 

n 

\bi gcap 

O 

\bigodot 

\prod 

u 

\bi gcup 

(8) 

\bigotimes 

\coprod 

u 

\bi gsqcup 

© 

\bigoplus 

\i nt 

V 

\bi gvee 

l±J 

\biguplus 

\oi nt 

A 

\bi gwedge 




Table VIII.8: Log-like Symbols 


\arccos 

\cos 

\csc 

\exp 

\ker 

\1 imsup 

\mi n 

\si nh 

\arcsi n 

\cosh 

\deg 

\gcd 

Mg 

\ln 

\Pr 

\sup 

\arctan 

\cot 

\det 

\hom 

\lim 

\1 og 

\sec 

\tan 

\arg 

\coth 

\dim 

Yinf 

\lirm'nf 

\max 

\si n 

\tanh 




Table VIII. 

9: Delimiters 



( 

( 

) ) 

T 

\uparrow 

ft 

\Uparrow 

[ 

[ 

] ] 

1 

\downarrow 

ft 

\Downarrow 

{ 

\{ 

1 \> 

: 

\updownarrow 

ft 

\Updownarrow 

L 

\lfloor 

J \rfloor 

r 

\1 cei 1 

1 

\rcei 1 

< 

\langle 

) \rangle 

/ 

/ 

\ 

\backslash 


\l 


Table Vlll.io: Large Delimiters 


| \rmoustache 
\arrowvert 


/ 


\lmoustache j 
\Arrowvert | 


\rgroup ( \lgroup 

\bracevert 
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Table VIII.ii: Math Mode Accents 

a \hat{a} a \acute{a} a \bar{a} a \dot{a} 

a \breve{a} a \check{a} a \grave{a} a \vec{a} 

a \ddot{a} a \tilde{a} 


Table VIII.12: Some other Constructions 


abc 

\widetilde{abc} 

abc 

\widehat{abc} 

abc 

\overl eftarrow{abc} 

abc 

\overrightarrow{abc} 

abc 

\overl i ne{abc} 

abc 

\underl i ne{abc} 

abc 

\overbrace{abc} 

abc 

\underbrace{abc} 

yfabc 

\sqrt{abc} 

y/abc 

\sqrt[n] {abc} 

f 

f’ 

abc 

xyz 

\f rac{abc}{xyz} 


Table VIII.13: AMS Delimiters 

r \ulcorner n \urcorner l \llcorner j \lrcorner 


Table VIII.14: AMS Arrows 



\dashri ghtarrow 


\dashl eftarrow 

1= 

\1 eftl eftarrows 

±4 

\1 eftri ghtarrows 


\L1 eftarrow 

«- 

\twoheadl eftarrow 

<— < 

\1 eftarrowtai 1 

<-P 

\1 ooparrowl eft 


\1 eftri ghtharpoons 


\curvearrowl eft 

O 

\ci rcl earrowl eft 

<1 

\Lsh 

tr 

\upuparrows 

1 

\upharpoonl eft 

j 

\downharpoonl eft 

—O 

\multimap 


\1 eftri ghtsqui gar row 


\ri ghtri ghtarrows 


\ri ghtl eftarrows 

=3 

\ri ghtri ghtarrows 


\ri ghtl eftarrows 

-» 

\twoheadri ghtarrow 

>— > 

\ri ghtarrowtai 1 


\looparrowright 


\ri ghtl eftharpoons 


\curvearrowri ght 

O 

\ci rcl earrowri ght 


\Rsh 

il 

\downdownarrows 

r 

\upharpoonri ght 

l 

\downharpoonri ght 

aa 4 

\ri ghtsqui garrow 


Table VIII. 15: AMS Negated Arrows 

\nleftarrow -o \nrightarrow 3= \nLeftarrow 

=t> \nRightarrow <+> \nleftrightarrow \nl_eftri ghtarrow 


Table VIII.16: AMS Greek 
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F \di gamma X \varkappa 

Table VIII.17: AMS Hebrew 
^ \beth “1 \daleth ] \gimel 


n 

□ 

Z 

D 

▲ 

★ 

X 

A 

© 

o 

\ 

■ 

C 


Table VIII.18: AMS Miscellaneous 


\hbar fi 
\square 0 
\measuredangl e J 
\Game Ik 
\blacktri angle ▼ 
\bigstar < 
\diagup \ 
\vartri angle V 
\circledS Z 
\mho d 
\backprime 0 
\blacksquare ♦ 
\complement 5 


\hsl ash 
\lozenge 
\nexi sts 
\Bbbk 

\bl acktri angl edown 
\sphericalangle 
\di agdown 
\tri angl edown 
\angl e 
\Fi nv 

\varnothi ng 

\blacklozenge 

\eth 


Table VIII.19: AMS Binary Operators 


+ 

\dotpl us 

\ 

\smal 1 setmi nus 

(Hi 

\Cap 

A 

\barwedge 

V 

\veebar 

X 

\doubl ebarwedge 

0 

\boxtimes 

□ 

\boxdot 

ffl 

\boxpl us 

K 

\1 times 

XI 

\rtimes 

X 

\leftthreetimes 

A 

\curlywedge 

Y 

\curlyvee 

e 

\ci rcl eddash 

® 

\ci rcl edci rc 

. 

\centerdot 

T 

\i ntercal 

y 

\Cup 

B 

\boxmi nus 

* 

\divideontimes 

X 

\rightthreetimes 

® 

\ci rcl edast 




Table VIII.20: AMS Binary Relations 


< 

\leqq 

< 

\leqslant 

< \eqslantless 

<: 

\lessapprox 


\approxeq 

< \lessdot 

A 

\lessgtr 

< 

> 

\lesseqgtr 

= \lesseqqgtr 

= 

\ri si ngdotseq 

= 

\fal 1 i ngdotseq 

— \backsim 

c 

\subseteqq 

<£ 

\Subset 

IZ \sqsubset 

< 

\curlyeqprec 

< 

\precsim 

^ \precapprox 

< 

\tri angl el efteq 

1= 

\vDash 

III- \Vvdash 

- 

\smal 1 frown 


\bumpeq 

~ \Bumpeq 

> 

\geqsl ant 


\eqslantgtr 

> \gtrsim 

> 

\gtrdot 


\ggg 

§ \gtrless 

> 

< 

\gtreqql ess 

zc 

\eqci rc 

= \ci rceq 

~ 

\thicksim 

~ 

\thi ckapprox 

2 \supseteqq 
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□ 

\sqsupset 

> 

\succcurlyeq 

> 

\curlyeqsucc 

< 

\succapprox 

> 

\vartri angl eri ght 

> 

\tri angl eri ghteq 

1 

\shortmi d 

11 

\shortparallel 

0 

\between 

a 

\varpropto 

◄ 

\bl acktri angl el eft 


\therefore 

► 

\bl acktri angl eri ght 


\because 

< 

\lesssim 

«< \m 

= 

\doteqdot 

S£ 

\backsimeq 

< 

\preccurl yeq 

<1 

\vart ri angl el eft 

- 

\small smile 

> 

\geqq 

;> 

\gtrapprox 

> 

< 

\gtreqless 

= 

\tri angl eq 

2> 

\Supset 

> 

\succsim 

11- 

\Vdash 

rh 

\pi tchfork 

3 

\backepsilon 



Table VIII. 

21: 

AMS Negated Binary Relations 

< 

\nl ess 

£ 

\nleq 


\nleqslant 

< 

\1 neq 

£ 

\1 neqq 

$ 

\1 vertneqq 

i 

\1 napprox 

£ 

\nprec 

£ 

\npreceq 


\precnapprox 


\nsim 

a 

\nshortmi d 

¥■ 

\nvdash 

£ 

\nvDash 

£ 

\ntriangleleft 

f 

\nsubseteq 

c 

\subsetneq 

£ 

\varsubsetneq 

£ 

\varsubsetneqq 

> 

\ngtr 

t 

\ngeq 


\ngeqq 

> 

\gneq 

£ 

\gneqq 

> 

\gnsim 

i 

\gnapprox 

£ 

\nsucc 

i 

\nsucceq 

> 

\succnsim 

& 

\succnapprox 

>r 

\nshortparal 1 el 

i 

\nparal 1 el 

* 

\nvDash 

& 

\ntri angl eri ght 


\ntri angl eri ghteq 

t 

\nsupseteq 

D 

\supsetneq 

2 

\varsupsetneq 

2 

\supsetneqq 

£ 

\nl eqq 

< 

\1 nsim 

< 

\precnsim 


\nmi d 

£ 

\ntri angl el efteq 

£ 

\subsetneqq 

> 

\ngeqsl ant 

£ 

\gvertneqq 

t 

\nsucceq 


\ncong 


\nVDash 

2 

\nsupseteqq 

2 

\varsupsetneqq 






Table VIII.22: Math Alphabets 


Required package 


ABCdef 

\mathrm{ABCdef} 


ABCdef 

\mathi tABCdef 


ABCdef 

\mathnormal {ABCdef} 


ft. SC 

\mathcal {ABC} 


ABC 

\mathcal {ABC} 

euscript with option: mathcal 


\mathscr{ABC} 

euscript with option: mathcr 

9123 (Ebef 

\mathf rak{ABCdef} 

eufrak 

ABC 

\mathbb{ABC} 

amsfonts or amssymb 


\mathscr{ABC} 

mathrsfs 



TUTORIAL IX 


TYPESETTING THEOREMS 


ix. i. Theorems in ET^X 

In Mathematical documents we often have special statements such as axioms (which are 
nothing but the assumptions made) and theorems (which are the conclusions obtained, 
sometimes known by other names like propositions or lemmas ). These are often typeset 
in different font to distinguish them from surrounding text and given a name and a num- 
ber for subsequent reference. Such distinguished statements are now increasingly seen in 
other subjects also. We use the term theorem-like statements for all such statements. 

UTeX provides the declaration \newtheorem to define the theorem-like statements 
needed in a document. This command has two arguments, the first for the name we 
assign to the environment and the second, the name to be printed with the statement. 
Thus if you want 


Theorem 1. The sum of the angles of a triangle is 180°. 


you first specify 

\newtheorem{thm} {Theorem} 

and then type 
\begi n{thm} 

The sum of the angles of a triangle is $180“\circ$. 

\end{thm} 

Note that in the command \newtheorem the first argument can be any name you fancy, in- 
stead of the thm given here. Also, it is a good idea to keep all your \newtheorem commands 
together in the preamble. 

The \newtheorem command has a couple of optional arguments which control the 
way the corresponding statement is numbered. For example if you want the above theo- 
rem to be numbered i.i (the first theorem of the first section) rather than a plain i, then 
you must specify 

\newtheorem{ thm} {Theorem} [section] 

in the \newtheorem command. Then the same input as above for the theorem produces 


Theorem IX. 1.1. The stun of the angles of a triangle is 180°. 


The next Theorem will be numbered 1.2, the third Theorem in the fourth section 
will be numbered 4.3 and so on. 
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The other optional argument of the \newtheorem command is useful when you have 
several different types of theorem-like statements (such as lemmas and corollaries) and 
you want some of them to share the same numbering sequence. For example if you want 

Theorem IX. 1.2. The sum of the angles of a triangle is 180°. 


An immediate consequence of the result is the following 
Corollary IX. 1.3. The sum of the angles of a quadrilateral is 360°. 

Then you must specify 

\newtheorem{cor} [thm] {Corol 1 ary} 

after the specification \newtheorem{thm} [section] and then type 
\begi n{thm} 

The sum of the angles of a triangle is $180~\ci rc$ . 
\end{thm} 

An immediate consequence of the result is the following 
Corollary IX. 1.4. The sum of the angles of a quadrilateral is 360°. 


The optional argument thm in the definition of the cor environment specifies that 
“Corollaries” and “Theorems” are to be numbered in the same sequence. 

A theorem-like environment defined using the \newtheorem command has also an 
optional argument which is used to give a note about the theorem such as the name of its 
discoverer or its own common name. For example, to get 

Theorem IX. 1.5 (Euclid). The sum of the angles of a triangle is 180°. 

you must type 

\begi n{thm} [Eucl i d] 

The sum of the angles of a triangle is $180~\ci rc$ . 

\end{thm} 

Note the optional argument Euclid after the \begin{thm}. This use of [...] for optional 
notes sometimes lead to unintended results. For example, to get 

Theorem IX. 1.6. [0, 1] is a compact subset of R. 

if you type 
\begi n{thm} 

[0,1] is a compact subset of $\mathbb{R}$ . 

\end{thm} 

then you get 

Theorem IX. 1.7 (0,1). is a compact subset of R. 

Do you see what happened? The string o,i within [ ] at the beginning of the theorem is 
considered an optional note by DTeX ! The correct way is to type 
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hi 


\begi n{thm} 

$ [0 , 1] $ is a compact subset of $\mathbb{R}$ . 

\end{thm} 

Now all the theorem-like statements produced above have the same typographical form — 
name and number in boldface and the body of the statement in italics. What if you need 
something like 


Theorem ix.i.i (Euclid). The sum of the angles of a triangle is 180°. 

Such customization is necessitated not only by the aesthetics of the author but often by 
the whims of the designers in publishing houses also. 

ix. 2. Designer theorems— The amsthm package 

The package amsthm affords a high level of customization in formatting theorem-like 
statements. Let us first look at the predefined styles available in this package. 

IX. 2. i. Ready made styles 

The default style (this is what you get if you do not say anything about the style) is termed 
pi ai n and it is what we have seen so far — name and number in boldface and body in italic. 
Then there is the def i ni ti on style which gives name and number in boldface and body in 
roman. And finally there is the remark style which gives number and name in italics and 
body in roman. 

For example if you put in the preamble 
\usepackage {amsthm} 

\newtheorem{thm} {Theorem} [section] 

\theoremstyl e{def i ni ti on} 

\newtheorem{dfn}{Defi ni ti on} [section] 

\theoremstyle{ remark} 

\newtheorem{ note} {Note} [section] 

\theoremstyl e{pl ai n} 

\newtheorem{l em} [thm] {Lemma} 

and then type somewhere in your document 
\begi n{dfn} 

A triangle is the figure formed by joining each pair 
of three non coll inear points by line segments. 

\end{dfn} 

\begi n{note} 

A triangle has three angles. 

\end{note} 

\begi n{thm} 

The sum of the angles of a triangle is $180“\circ$. 

\end{thm} 

\begi n { 1 em} 

The sum of any two sides of a triangle is greater than or equal to the third. 
\end{lem} 
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then you get 

Definition IX.2.1. A triangle is the figure formed by joining each pair of three non collinear 
points by line segments. 

Note IX.2.1. A triangle has three angles, 'note 
Theorem IX.2.1. The stun of the angles of a triangle is 180°. 

Lemma IX.2.2. The sum of any two sides of a triangle is greater than or equal to the third. 


Note how the \theoremstyle command is used to switch between various styles, espe- 
cially the last \theoremstyl e{pl ai n} command. Without it, the previous \theoremstyle{ remar 
will still be in force when lem is defined and so “Lemma” will be typeset in the remark 
style. 

IX.2.2. Custom made theorems 

Now we are ready to roll our own “theorem styles”. This is done via the \newtheoremstyl e 
command, which allows us to control almost all aspects of typesetting theorem like state- 
ments. this command has nine parameters and the general syntax is 

\newtheoremstyl e% 

{name}% 

{abovespace}% 

{belou’space}% 

{bodyfont}% 

{ indent}% 

{headfont}% 

{beadpunct}% 

{headspace}% 

{custom-head-spec}% 


The first parameter name is the name of the new style. Note that it is not the name of the 
environment which is to be used later. Thus in the example above remark is the name of a 
new style for typesetting theorem like statements and note is the name of the environment 
subsequently defined to have this style (and Note is the name of the statement itself). 

The next two parameters determine the vertical space between the theorem and the 
surrounding text — the abovespace is the space from the preceding text and the beloivs- 
pace the space from the following text. You can specify either a rigid length (such as 
i2pt) or a rubber length (such as \baselineskip) as a value for either of these. Leaving 
either of these empty sets them to the “usual values” (Technically the \topsep). 

The fourth parameter bodyfont specifies the font to be used for the body of the 
theorem-like statement. This is to be given as a declaration such as \scshape or \bfseri es 
and not as a command such as \textsc or \textbf. If this is left empty, then the main 
text font of the document is used. 

The next four parameters refer to the tbeorembead — the part of the theorem like 
statement consisting of the name, number and the optional note. The fifth parameter 
indent specifies the indentation of tbeorembead from the left margin. If this is empty, 
then there is no indentation of the tbeorembead from the left margin. The next parameter 
specifies the font to be used for the tbeorembead. The comments about the parameter 
bodyfont, made in the previous paragraph holds for this also. The parameter headpunct 
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(the seventh in our list) is for specifying the punctuation after the theoremhead. If you 
do not want any, you can leave this empty. The last parameter in this category (the last 
but one in the entire list), namely headspace, determines the (horizontal) space to be left 
between the theoremhead and the theorembody. If you want only a normal interword 
space here put a single blank space as { } in this place. (Note that it is not the same as 
leaving this empty as in {}.) Another option here is to put the command \newline here. 
Then instead of a space, you get a linebreak in the output; that is, the theoremhead will 
be printed in a line by itself and the theorembody starts from the next line. 

The last parameter custom-head-spec is for customizing theoremheads. Since it needs 
some explanation (and since we are definitely in need of some breathing space), let us now 
look at a few examples using the eight parameters we’ve already discussed. 

It is almost obvious now how the last theorem in Section i (see Page in) was 
designed. It was generated by 

\newtheoremstyle{mystyle}{}{}{\sl shape}{}{\scshape}{ . }{ }{} 

\theoremstyle{my style} 

\newtheorem{mythm} {Theorem} [section] 

\begi n{mythm} 

The sum of the angles of a triangle is $180“\circ$. 

\end{mythm} 

As another example, consider the following 

\newtheoremstyle{mynewstyl e}{12pt}{12pt}{\i tshape}% 

{}{\sffami 1 y } { : }{\newl i ne}{} 

\theoremstyle{mynewstyle} 

\newtheorem{mynewthm} {Theorem} [section] 

\begi n{mynewthm} [Eucl i d] 

The sum of the angles of a triangle is $180“\ci rc$. 

\end{mynewthm} 

This produces 

Theorem ix.2.1 (Euclid): 

The sum of the angles of a triangle is 180°. 


Do you need anything more? Perhaps yes. Note that theoremhead includes the op- 
tional note to the theorem also, so that the font of the number and name of the theorem- 
like statement and that of the optional note are always the same. What if you need 
something like 


Cauchy’s Theorem (Third Version). IfG is a simply connected open subset of C, then for every 
closed rectifiable curve y in G, we have 

f/=°- 


It is in such cases, that the last parameter of \newtheoremstyl e is needed. Using it we 
can separately customize the name and number of the theorem-like statement and also 
the optional note. The basic syntax for setting this parameter is 
{commands#lcommands#2cotnmands#3} 

where #1 corresponds to the name of the theorem-like statement, #2 corresponds to its 
number and #3 corresponds to the optional note. We are here actually supplying the 
replacement text for a command \thmhead which has three arguments. It is as if we are 
defining 
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\renewcommand{\thmhead} [B] { . . .#1. . .#2. . .#3} 

but without actually typing the \renewcommand{\thmhead}[3]. For example the theorem 
above (Cauchy’s Theorem) was produced by 

\newtheoremstyle{nonum}{}{}{\itshape}{}{\bfseries}{.}{ }{#1 (\mdseries #3)} 
\theoremstyle{nonum} 

\newtheo rem{Cauchy} {Cauchy ’ s Theorem} 

\begi n{Cauchy} [Thi rd Version] 

If $G$ is a simply connected open subset of $\mathbb{C}$ , then for every closed 
rectifiable curve $\gamma$ in $G$, we have 
\begi n{equati on*} 

\int_\gamma f=0. 

\end{equati on*} 

\end{Cauchy} 

Note that the absence of #2 in the custom-bead-spec, suppresses the theorem number and 
that the space after #1 and the command (\mdseri es#3) sets the optional note in medium 
size within parentheses and with a preceding space. 

Now if you try to produce 


Riemann Mapping Theorem. Every open simply connected proper subset of C is analytically 
bomeomorphic to the open unit disk in C. 

by typing 

\theoremstyle{nonum} 

\newtheorem{Riemann}{Riemann Mapping THeorem} 

\begi n{Riemann}Every open simply connected proper subset of $\mathbb{C}$ is analytically 
homeomorphic to the open unit disk in $\mathbb{C}$ . 

\end{Ri emann} 

you will get 


Riemann Mapping Theorem (). Every open simply connected proper subset of C is analytically 
homeomorphic to the open unit disk in C. 

Do you see what is happened? In the \theoremstyle{diffnotenonum}, the parameter 
controlling the note part of the theoremhead was defined as (\mdseries # 3 ) and in the 
\newtheorem{Ri emann}, there is no optional note, so that in the output, you get an empty 
“note”, enclosed in parantbeses (and also with a preceding space). 

To get around these difficulties, you can use the commands \thmname, \thmnumber 
and \thmnote within the { custom-bead-spec } as 

{\tbmnaLme{commands#l}% 

\thmr\umber{commands#2}% 

\tbmnote{commands#3}} 

Each of these three commands will typeset its argument if and only if the correspond- 
ing argument in the \thmhead is non empty. Thus the correct way to get the Riemann 
Mapping theorem in Page 114 is to input 
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\newtheoremstyle{newnonum}{}{}{\i tshape}{}{\bfseri es}{ . }{ }% 
{\thmname{#l}\thmnote{ (\mdseries #3)}} 

\theoremstyl e{newnonum} 

\newtheorem{newRi emann}{Ri emann Mapping Theorem} 

\begi n{newRiemann} Every open simply connected proper subset of $\mathbb{C}$ is 
analytically homeomorphic to the open unit disk in $\mathbb{C}$ . 

\end{newRi emann} 

Then you can also produce Cauchy’s Theorem in Page 113 by typing 
\theoremstyle{newnonum} 

\newtheorem{newCauchy} {Cauchy ’ s Theorem} 

\begi n{newCauchy} [Thi rd Version]If $G$ is a simply connected open subset of 
$\mathbb{C}$ , then for every closed rectifiable curve $\gamma$ in SGS, we have 
\begi n{equati on*} 

\i nt_\gamma f=0 
\end{equati on*} 

\end{newCauchy} 

The output will be exactly the same as that seen in Page 113. Now suppose you 
want to highlight certain theorems from other sources in your document, such as 


Axiom 1 in [1]. Things that are equal to the same thing are equal to one another. 

This can be done as follows: 

\newtheoremstyle{ci ti ng} { } { } {\i tshape}{}{\bfseri es}{ . }{ }{\thmnote{#3}} 

\theoremstyl e{ci ti ng} 

\newtheorem{ci t}{} 

\begi n{ci t} [Axiom 1 in \cite{eu}] 

Things that are equal to the same thing are equal to one another. 

\end{ci t} 

Of course, your bibliography should include the citation with label eu. 

IX. z. 3. There is more! 

There are some more predefined features in amsthm package. In all the different examples 
we have seen so far, the theorem number comes after the theorem name. Some prefer to 
have it the other way round as in 

IX.2.1 Theorem (Euclid). The sum of the angles in a triangle is 180°. 

This effect is produced by the command \swapnumbers as shown below: 

\swapnumbers 
\theoremstyl e{pl ai n} 

\newtheorem{numfi rstthm}{Theorem} [section] 

\begi n{numf i rstthm} [Eucl i d] 

The sum of the angles in a triangle is $180“\circ$ 

\end{numfi rstthm} 
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Note that the \swapnumbers command is a sort of toggle-switch, so that once it is given, 
all subsequent theorem-like statements will have their numbers first. If you want it the 
other way for some other theorem, then give \swapnumbers again before its definition. 

A quick way to suppress theoremnumbers is to use the \newtheorem* command as in 
\newtheorem*{numl essthm} {Theorem} [section] 

\begi n{numl essthm} [Eucl i d] 

The sum of the angles in a triangle is $180“\circ$. 

\end{numl essthm} 

to produce 

Euclid. The sum of the angles in a triangle is 180°. 

Note that this could also be done by leaving out #2 in the custom-head-spec parameter 
of \newtheoremstyl e, as seen earlier. 

We have been talking only about theorems so far, but Mathematicians do not live 
by theorems alone; they need proofs. The amsthm package contains a predefined proof 
environment so that the proof of a theorem-like statement can be enclosed within \begi n 
{proof} . . . \end{proof} commands as shown below: 

\begi n{thmsec} 

The number of primes is infinite. 

\end{thmsec} 

\begi n{proof} 

Let $\{p_l, p_2 ,\dotsc p_k\}$ be a finite set of primes. Define $n=p_lp_2\dotsm 
p_k+l$. Then either $n$ itself is a prime or has a prime factor. Now $n$ is 
neither equal to nor is divisible by any of the primes $p_l,p_2,\dotsc p_k$ so 
that in either case, we get a prime different from $p_l,p_2,\dotsc p_k$. Thus 
no finite set of primes can include all the primes. 

\end{proof} 

to produce the following output 
Theorem IX.2.3. The number of primes is infinite. 

Proof. Let \p\, p 2 ,... pd be a finite set of primes. Define n = pip 2 ■ ■ ■ pt + 1. Then either n itself 
is a prime or has a prime factor. Now n is neither equal to nor is divisible by any of the primes 
pi, p 2 , ■ ■ ■ Pk so that in either case, we get a prime different from p\,p 2 , . ■ .pk- Thus no finite set 
of primes can include all the primes. □ 

There is an optional argument to the proof environment which can be used to change 
the proofhead. For example, 

\begi n{proof } [\textsc{Proof\ , (Eucl i d) } : ] 

\begi n{proof} 

Let $\{p 1 , p_2 ,\dotsc p_k\}$ be a finite set of primes. Define $n=p_lp_2\dotsm 

p_k+l$. Then either $n$ itself is a prime or has a prime factor. Now $n$ is 
neither equal to nor is divisible by any of the primes $p_l,p_2,\dotsc p_k$ so 
that in either case, we get a prime different from $p_l,p_2,\dotsc p_k$. Thus 
no finite set of primes can include all the primes. 

\end{proof} 
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produces the following 

PROOF (Euclid): Let {pi,p2,- ■ -Pk] be a finite set of primes. Define n = pip 2 ■■ -pk + 1. Then 
either n itself is a prime or has a prime factor. Now n is neither equal to nor is divisible by any 
of the primes pi,p2,--. Pk so that in either case, we get a prime different from p 1 ,p 2 ...p k . Thus 
no finite set of primes can include all the primes. □ 

Note that the end of a proof is automatically marked with a □ which is defined in the 
package by the command \qedsymboT If you wish to change it, use \renewcommand to 
redefine the \qedsymbol . Thus if you like the original “Halmos symbol” I to mark the 
ends of your proofs, include 

\newcommand{\halmos}{\rul e{lmm}{2 . 5mm}} 

\renewcommand{\qedsymbol }{\halmos} 

in the preamble to your document. 

Again, the placement of the \qedsymbol at the end of the last line of the proof is done 
via the command \qed. The default placement may not be very pleasing in some cases as 
in 

Theorem IX.2.4. The square of the sum of two numbers is equal to the sum of their squares 
and twice their product. 

Proof. This follows easily from the equation 

(x+ijf = x 2 + if+ 2 xy 

□ 

It would be better if this is typeset as 

Theorem IX.2.5. The square of the sum of two numbers is equal to the sum of their squares 
and twice their product. 

Proof. This follows easily from the equation 

□ (x + y) 2 = x 2 + y 2 + 2 xy 

which is achieved by the input shown below: 

\begi n{proof} 

This follows easily from the equation 
\begi nfequati on} 

(x+y) "2=x“2+y“2+2xy\tag*{\qed} 

\end{equati on} 

\renewcommand{\qed}{} 

\end{proof} 

For this trick to work, you must have loaded the package amsmath without the leqno 
option. Or, if you prefer 

Proof. This follows easily from the equation 

(x + y) 2 = x 2 + y 2 + 2xy □ 


Then you can use 
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\begi n{proof} 

This follows easily from the equation 
\begi n{equati on*} 

(x+y) “2=x~2+y“2+2xy\qed 
\end{equati on*} 

\renewcommand{\qed}{} 

\end{proof} 


ix. 3. Housekeeping 

It is better to keep all \newtheoremstyle commands in the preamble than scattering them 
all over the document. Better still, you can keep them together with other customization 
in a personal . sty file and load it using the \usepackage command in the preamble. Also, 
within this . sty file, you can divide your \newtheorem commands into groups and preface 
each group with the appropriate \theoremstyle. 

Bibliography 
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SEVERAL KINDS OF BOXES 


The method of composing pages out of boxes lies at the very heart of TgX and many 
UTeX constructs are available to take advantage of this method of composition. 

A box is an object that is treated by TeX as a single character. A box cannot be split 
and broken across lines or pages. Boxes can be moved up, down, left and right. UTeX 
has three types of boxes. 

LR (left-right) The content of this box are typeset from left to right. 

Par (paragraphs) This kind of box can contain several lines, which will be typeset 
in paragraph mode just like normal text. Paragraphs are put one on top of the 
other. Their widths are controlled by a user specified value. 

Rule A thin or thick line that is often used to separate various logical elements on 
the output page, such as between table rows and columns and between running 
titles and the main text. 


X.I. LR BOXES 


The usage information of four types of LR boxes are given below. The first line considers 
the text inside the curly braces as a box, with or without a frame drawn around it. For 
instance, \fbox{some words} gives some words whereas \mbox will do the same thing, 
but without the ruled frame around the text. 


\mbox{fexf} 

\makebox{widtb} {pos} {text} 

\fbox{text} 

\f ramebo x{width} {pos} {text} 

The commands in the third and fourth lines are a generalization of the other com- 
mands. They allow the user to specify the width of the box and the positioning of text 
inside. 

\makebox{5cm}{some words} \par 
\f ramebox{5cm}{r}{some words} 

In addition to the centering the text with positional argument [c] (the default), you 
can position the text flush left ( [1 ] ). UTeX also offers you an [s] specifier that will stretch 
your text from the left margin to the right margin of the box provided it contains some 
stretchable space. The inter-word space is also stretchable and shrinkable to a certain 
extent. 

With ILfiX, the above box commands with arguments for specifying the dimensions 
of the box allow you to make use of four special length parameters: \width, \height, 


some words 


some words 
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\depth and \total height. They specify the natural size of the text, where \total height 
is the sum of the \height and \depth. 


A few words of advice 
A few words of advice 
A few words of advice 


\framebox{A few words of advice}\\[6pt] 

\f ramebox[5cm] [s] {A few words of advice}\\[6pt] 

\f rameboxfl. 5\width}{A few words of advice} 

As seen in the margin of the current line, boxes with zero width can be used to make text 
stick out in the margin. This effect was produced by beginning the paragraph as follows: 

\makebox{Omm}{r}{$\Leftri ghtarrow$} 

As seen in the margin of the \dots 

The appearance of frameboxes can be controlled by two style parameters. 

\fboxruieThe width of the lines comprising the box produced with the command \fbox 
or \f ramebox. The default value in all standard classes is o.4pt. 

\f boxsep The space left between the edge of the box and its contents by \fbox or \f ramebox. 
The default value in all standard classes is 3pt. 


Text in a box 


Text in a box 


\fbox{Text in a box} 

\setl ength\f boxrul e{2pt}\setl ength\fboxsep{2mm} 

\fbox{Text in a box} 

Another interesting possibility is to raise or lower boxes. This can be achieved by 
the very powerful \raisebox command, which has two obligatory and two optional pa- 
rameters, defined as follows: 

\rai sebo {depth} {height} {contents} 

An example of lowered and elevated text boxes is given below. 

baseline u P ward baseline downward baseline 


baseline \rai sebox{lex}{upward} baseline 
\rai sebox{-lex}{downward} basel i ne 






x.2. Paragraph boxes 


izi 


As with \makebox and \framebox the hTgX implementation of \raisebox offers you 
the use of the lengths \height, \depth, \total height and \width in the first three argu- 
ments. Thus, to pretend that a box extends only 90% of its actual height above the 
baseline you could write: 

\rai sebox{0pt}{0. 9\hei ght}{text} 


or to rotate a box around its lower left corner (instead of its reference point lying on the 
baseline), you could raise it by its \depth first, e.g.: 



$x_l$ \doturn{\fbox{Bad thing}}\\ 

$x_2$ \doturn{\rai sebox{\depth}\\ 

{\fbox{Bad thing}}}\\ 

$x_3$ \doturn{\rai sebox{-\hei ght}\\ 

{\fbox{Bad thing}}} $x_4$ 

x.2. Paragraph boxes 

Paragraph boxes are constructed using the \parbox command or mini page environment. 
The text material is typeset in paragraph mode inside a box of width width. The vertical 
positioning of the box with respect to the text baseline is controlled by the one-letter 
optional parameter pos ( [c], [t], and [b] ). 

The usage for \parbox command is, 

\pa.rbox{pos}{width}{text } 

whereas that of the minipage environment will be: 

\begi n{mi ni page} {pos} {width} 

. . . here goes the text matter . . . 

\end{mi ni page} 

The center position is the default as shown by the next example. You can also observe 
that LTpX might produce wide inter-word spaces if the measure is incredibly small. 

This is the right-most parbox. 
Note that the typeset text looks 
CURRENT LINE sloppy because UTpX cannot 

nicely balance the material in 
these narrow columns. 

The code for generating these three \parbox’s in a row is given below: 

\parbox{ . 3\bs linewidth} 

{This is the contents of the left-most parbox.} \hfill CURRENT LINE \hfill 
\parbox{ . 3\bs 1 i newidth}{Thi s is the right-most parbox. Note that the typeset 
text looks sloppy because \LaTeX{} cannot nicely balance the material in 
these narrow columns.} 


This is the contents of the left- 
most parbox. 
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The minipage environment is very useful for the placement of material on the page. 
In effect, it is a complete mini-version of a page and can contain its own footnotes, para- 
graphs, and array, tabular and multicols (we will learn about these later) environments. 
A simple example of minipage environment at work is given below. The baseline is indi- 
cated with a small line. 

\begi n{mi ni page}{b}{ . B\1 i newi dth} 

The mini page environment creates a vertical box like the parbox command. 

The bottom line of this mini page is aligned with the 
\end{mi ni page}\hrul efi 1 1 
\begi n{mi ni page}{c}{ . B\1 i newi dth} 
middle of this narrow parbox, which in turn is 
\end{mi ni page}\hrul efi 1 1 
\begi n{mi ni page}{t}{ . 3\1 i newi dth} 

the top line of the right hand mini page. It is recommended that the user 
experiment with the positioning arguments to get used to their effects. 
\end{mi ni page} 

The minipage environment 
creates a vertical box like 
the parbox command. The 
bottom line of this minipage is . „ . . 

i- a vu.i middle of this narrow parbox, , „ ,. £ , . , „ , , 

aligned with the ' the top line ot the right hand 

which in turn is ■ T „ ■ a a 

mimpage. It is recommended 

that the user experiment with 
the positioning arguments to 
get used to their effects. 

x.3. Paragraph boxes with specific height 

In ETpX, the syntax of the \parbox and minipage has been extended to include two more 
optional arguments. 

\pa.rbox{pos}{height}{inner pos} {width} {text} 

is the usage for \parbox command, whereas that of the minipage environment will be: 

\begi n{mi ni page} {pos} {height} {inner pos}{width } 

. . . here goes the text matter . . . 

\end{mi ni page} 

In both cases, height is a length specifying the height of the box; the parameters \hei ght, 
\width, \depth, and \total height may be employed within the emph argument in the 
same way as in the ividth argument of \makebox and \f ramebox. 

The optional argument inner pos states how the text is to be positioned internally, 
something that is only meaningful if height has been given. Its possible values are: 

t To push the text to the top of the box. 

b To shove it to the bottom, 

c To center it vertically, 

s To stretch it to fill up the whole box. 

In the last case, we must specify the interline space we wish to have and the deviations 
allowed from this value as in the example below. 

Note the difference between the external positioning argument pos and the internal 
one inner pos: the former states how the box is to be aligned with the surrounding text, 


X-4 - Nested boxes 


1Z3 


while the latter determines how the contents are placed within the box itself. See an 
example below. We frame the minipages to make it more comprehensible. 


This is a mini- 
page with a 
height of 3 cm 
with the text 
aligned at the 
top. 


In this minipage 
of same height, 
the text is verti- 
cally centered. 


In this third box 
of same height, 
text is aligned at 
the bottom. 


In this fourth 
box of same 
height, the text 
is stretched to 
fill in the entire 
vertical space. 


See the code that generated the above boxed material: 

\begi n{mi ni page} [b] [Bern] [t] {2cm} 

This is a minipage with a height of 3"cm with the text aligned 
at the top. 

\end{mi ni page}\hfi 1 1 

\begi n{mi ni page} [b] [Bern] [c] {2cm} 

In this minipage of same height, the text is vertically centered. 

\end{mi ni page}}\hfi 1 1 

\begi n{mi ni page} [b] [3cm] [b] {2cm} 

In this third box of same height, text is aligned at the bottom. 

\end{mi ni page}\hfi 11 

\begi n{mi ni page}{b}{3cm}{s}{2cm} 

\basel i neski p lOpt plus 2pt minus 2pt 

In this fourth box of same height, the text is stretched to fill in the entire 
vertical space. 

\end{mi ni page} 

In the last minipage environment the command \basel i neski p gets the interline 
space to be 10 points text allows it to be as low as 8 points or as high as iz points. 


x.4. Nested boxes 

The box commands described above may be nested to any desired level. Including an 
LR box within a parbox or a minipage causes no obvious conceptual difficulties. The 
opposite, a parbox within an LR box, is also possible, and is easy to visualize if one keeps 
in mind that every box is a unit, treated by TgX as a single character of the corresponding 
size. 


A parbox inside an \fbox command has the effect that the entire parbox is 
framed. The present structure was made with 

\fbox{\fbox{\parbox{ . 75\1 i newidth) {A parbox ...}}} 

This is a parbox of width . 75 X 11 newidth inside an fbox inside a second fbox, 
which thus produces the double framing effect. 
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x.5. Rule boxes 

A rule box is basically a filled-in black rectangle. The syntax for the general command is: 
\rul e{lift} {width} {height} 

which produces a solid rectangle of width width and height height, raised above the 
baseline by an amount lift. Thus 

\rul e{8mm}{3mm} 

generates 

and 

\rul e{3i n}{ . 2pt} 
generates 


Without an optional argument lift, the rectangle is set on the baseline of the current 
line of the text. The parameters lift, width and height are all lengths. If lift has a negative 
value, the rectangle is set below the baseline. 

It is also possible to have a rule box of zero width. This creates an invisible line with 
the given height. Such a construction is called a strut and is used to force a horizontal 
box to have a desired height or depth that is different from that of its contents. 
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XI. i. THE figure ENVIRONMENT 

Figures are really problematical to present in a document because they never split between 
pages. This leads to bad page breaks which in turn leave blank space at the bottom 
of pages. For fine-tuning that document, the typesetter has to adjust the page breaks 
manually. 

But ETgX provides floating figures which automatically move to suitable locations. 
So the positioning of figures is the duty of UTeX. 

XI. i . i . Creating floating figures 

Floating figures are created by putting commands in a figure environment. The con- 
tents of the figure environment always remains in one chunk, floating to produce good 
page breaks. The following commands put the graphic from figure.eps inside a floating 
figure: 

\begi n{fi gure} 

\centeri ng 

\i ncl udegraphi cs{fi gure.eps} 

\caption{This is an inserted EPS graphic} 

\label {figl} 

\end{fi gure} 


Features 

• The optional \label command can be used with the \ref, and \pageref commands 
to reference the caption. The \label command must be placed immediately after 
the \caption 

• If the figure environment contains no \capti on commands, it produces an unnum- 
bered floating figure. 

• If the figure environment contains multiple \caption commands, it produces multi- 
ple figures which float together. This is useful in constructing side-by-side graphics 
or complex arrangements. 

• A list of figures is generated by the \listoffigures command. 

• By default, the caption text is used as the caption and also in the list of figures. 
The caption has an optional argument which specifies the list-of-figure entry. For 
example, 


\capti on [ List Text ] {Caption Text} 
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Figure XI. i: This is an inserted EPS graphic 


causes “Caption Text” to appear in the caption, but “List Text” to appear in the 
list of figures. This is useful when using long, descriptive captions. 

• The figure environment can only be used in outer paragraph mode, preventing it 
from being used inside any box (such as parbox or minipage). 

• Figure environments inside the paragraphs are not processed until the end of the 
paragraph. For example: 

text text text text text text 

\begi n{fi gure} 

\end{fi gure} 

text text text text text text 

XI. 1.2. Figure placement 

The fi gure environment has an optional argument which allows users to specify possible 
figure locations. The optional argument can contain any combination of the letters: h, t, 
b, p. 

h Place the figure in the text where the figure command is located. This option cannot 
be executed if there is not enough room remaining on the page, 
t Place the figure at the top of the page, 
b Place the figure at the bottom of a page, 
p Place the figure on a page containing only floats. 


If no optional arguments are given, the placement options default to [tbp] . 

When we input a float, LTeX will read that float and hold it until it can be placed 
at a better location. Unprocessed floats are those which are read by UTeX but have not 
yet been placed on the page. Though the float-placing is done by LTeX, sometimes the 
user has to invoke commands to process unprocessed floats. Following commands will 
do that job: 


XI. I . The fi gu re ENVIRONMENT 
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\cl earpage This command places unprocessed floats and starts a new page. 

\FloatBarrier This command causes all unprocessed floats to be processed. This is 
provided by the pi acei ns package. It does not start a new page, unlike 
\cl earpage. 

Since it is often desirable to keep floats in the section in which they were issued, the 
secti on option 

\usepackage [secti on] {pi acei ns} 

redefines the \section command, inserting a \FloatBarrier command before each sec- 
tion. Note that this option is very strict. This option does not allow a float from the 
previous section to appear at the bottom of the page, since that is after the start of a new 
section. 

The below option 
\usepackage [be! ow] {pi acei ns} 

is a less-restrictive version of the section option. It allows floats to be placed after the 
beginning of a new section, provided that some of the previous section appears on the 
page. 

\afterpage/\cl earpage The afterpage package provides the \afterpage command which 
executes a command at the next naturally-ocurring page break. 

Therefore, using \afterpage{\cl earpage} causes all unprocessed floats to be cleared 
at the next page break. \afterpage{\cl earpage} is especially useful when producing 
small floatpage figures. 

XI. 1 . 3 . Customizing float placement 

The following style parameters are used by TTgX to prevent awkward-looking pages 
which contain too many floats or badly-placed floats. 

Float placement counters 

\topnumber The maximum number of floats allowed at the top of a text page (the 
default is 2). 

\bottomnumber The maximum number of floats allowed at the bottom of a text page 
(the default is 1). 

\total number The maximum number of floats allowed on any one text page (the de- 
fault is 3). 

These counters prevent FTgX from placing too many floats on a text page. These 
counters do not affect float pages. Specifying a ! in the float placement options causes 
FTgX to ignore these parameters. The values of these counters are set with the \setcounter 
command. For example, 

\setcounter{total number}{2} 

prevents more than two floats from being placed on any text page. 

Figure fractions 

The commands given below control what fraction of a page can be covered by floats 
(where “fraction” refers to the height of the floats divided by \textheight). The first 
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three commands pertain only to text pages, while the last command pertains only to float 
pages. Specifying a ! in the float placement options causes ETgX to ignore the first three 
parameters, but \fl oatpagef racti on is always used. The value of these fractions are set 
by \renewcommand. For example, 

\renewcommand{\textf racti on}{0 . 3 } 


\textf racti on 


\topf racti on 


\bottomf racti on 


\f ' 1 oatpagef racti on 


The minimum fraction of a text page which must be occupied by 
text. The default is o.i, which prevents floats from covering more 
than 8o% of a text page. 

The maximum fraction of a text page which can be occupied by 
floats at the top of the page. The default is 0.7, which prevents any 
float whose height is greater than 70% of \textheight from being 
placed at the top of a page. 

The maximum fraction of a text page which can be occupied by 
floats at the bottom of the page. The default is 0.3, which prevents 
any float whose height is greater than 40% of \textheight from 
being placed at the bottom of a text page. 

The minimum fraction of a float page that must be occupied by 
floats. Thus the fraction of blank space on a float page cannot be 
more than l-\fl oatpagef racti on. The default is 0.5. 


XI. 1.4. Using graphics in IhTpX 

This section shows how graphics can be handled in UTpX documents. While UTgX can 
import virtually any graphics format, Encapsulated PostScript (EPS) is the easiest graphics 
format to import into KTeX. The ‘eps’ files are inserted into the file using command 
\i ncl udegraphi cs file.eps 


The \i ncl udegraphi cs command 


\i ncl udegraphi cs [ options ] {filename} 

The following options are available in \i ncl udegraphi cs command: 

wi dth The width of the graphics (in any of the accepted TeX units), 
hei ght The height of the graphics (in any of the accepted T£X units), 
total hei ght The totalheight of the graphics (in any of the accepted T£X units). 

scale Scale factor for the graphic. Specifying scale = 2 makes the graphic twice 
as large as its natural size. 

angle Specifies the angle of rotation, in degrees, with a counter-clockwise (anti- 
clockwise) rotation being positive. 


Graphics search path 

By default, UT£X looks for graphics files in any directory on the T£X search path. In addi- 
tion to these directories, UTeX also looks in any directories specified in the \graphi cspath 
command. For example, 

\graphi cspath { {di rl/}{di r2/}} 
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\i ncl udegraphi cs [ widtb=lin} { tex.png } 



\i ncl udegraphi cs [ height=1.5in ] {tex.png} 



\i ncl udeg raphi cs [ scale=.25,angle=45 ] { tex.png } 



\i ncl udeg raphi cs [ scale=.25,angle=90 ] {tex.png} 


tells KTgX to look for graphics files also in di rl/ and di r2/. For Macintosh, this becomes 
\g raphi cspath{{di rl: }{di r2 : }} 

Graphics extensions 

The \DeclareCraphicsExtensions command tells TTeX which extensions to try if a file 
with no extension is specified in the \i ncl udegraphi cs command. For convenience, a 
default set of extensions is pre-defined depending on which graphics driver is selected. 
For example if dvi ps is used, the following graphics extensions (defined in dvi ps . def ) are 
used by default 

\Decl areGraphi csExtensi ons{ .eps,.ps,.eps.gz,.ps.gz,.eps.Z} 

With the above graphics extensions specified, \i ncl udegraphi cs file first looks for fi le. eps, 
then file.ps, then file file.eps.gz, etc. until a file is found. This allows the graphics to 
be specified with 

\i ncl udegraphi cs{ file} 


instead of 
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\i ncl udegraphi cs {fUe.eps} 


XI. 1. 5. Rotating and scaling objects 

In addition to the \i ncl udegraphi cs command, the graphi cx package includes four other 
commands which rotate and scale any RTpX object: text, EPS graphic, etc. 

\scal ebox{2}{\i ncl udegraphi cs{fi 1 e . eps}} 

\resi zebox{4i n}{ ! }{\i ncl udegraphi cs{fi 1 e . eps}} 

\rotatebox{45}{\i ncl udegraphi cs{fi 1 e . eps}} 

produces the same three graphics as 

\i ncl udegraphi cs [seal e=2] {fi 1 e . eps} 

\i ncl udegraphi cs [wi dth=4i n] {f i 1 e . eps} 

\i ncl udegraphi cs [angl e=45] {fi 1 e . eps} 


For example, the following are produced with 




However, the \i ncl udegraphi cs is preferred because it is faster and produces more 
efficient PostScript. 


XI. 2. The table ENVIRONMENT 

With the box elements already explained in the previous chapter, it would be possible to 
produce all sorts of framed and unframed tables. However, ETpXoffers the user far more 
convenient ways to build such complicated structures. 

XI. 2. 1. Constructing tables 

The environments tabular and tabular* are the basic tools with which tables can be 
constructed. The syntax for these environments is: 

\begi n {tabular} [pos] {cols} rows \end {tabular} 

\begin {tabular*} {width} ipos} {cols} rows \e.nd{tabular*} 

Both the above environments actually create a minipage. The meaning of the above 
arguments is as follows: 

pos Vertical positioning arguments (see also the explanation of this argument for 
parboxes). It can take on the values: 
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t The top line of the table is aligned with the baseline of the current 

external line of text. 

b The bottom line of the table is aligned with the external baseline. 

With no positioning argument given, the table is centered on the external base- 
line. 

This argument applies only to the tabular* environment and determines its 
overall width. In this case, the cols argument must contain the ©-expression 
(see below) @{\extracolsep{\fill}} somewhere after the first entry. For the 
other two environments, the total width is fixed by the textual content. 

The column formatting argument. There must be an entry for every column, 
as well as possible extra entries for the left and right borders of the table or for 
the inter-column spacings. The possible column formatting symbols are: 

1 The column contents are left justified, 

c The column contents are centered, 

r The column contents are right justified, 

jwd} The text in this column is set into lines of width wd 

and the top line is aligned with the other columns. 

In fact, the text is set in a parbox with the command 
\parbo x[f\{wd} {column text}. 

*{num}(cols} The column format contained in cols is reproduced 
num times, so that *{3}{ | c | } | is the same as | c | c | c | . 

The available formatting symbols for right and left borders and for the inter-column 
spacing are: 

Draws a vertical line. 

|| Draws two vertical lines next to each other. 

©{text} This entry is referred to as an ©-expression, and inserts 

text in every line of the table between the two columns 
where it appears. 

©-expression removes the inter-column spacing that is automatically put between 
each pair of columns. If white space is needed between the inserted text and the next col- 
umn, this must be explicitly included with \hspace{ } within the text of the ©-expression. 

If the inter-column spacing between two particular columns is to be something other than 
the standard, this may be easily achieved by placing @{\hspace{wd}} between the ap- 
propriate columns in the formatting argument. This replaces the standard inter-column 
spacing with the width wd. 

An \extracolsep{tfd} within an ©-expression will put extra spacing of amount wd 
between all the following columns, until countermanded by another \extracolsep com- 
mand. In contrast to the standard spacing, this additional spacing is not removed by later 
©-expression. In the \tabul ar* environment, there must be a command @{\extracol sep\fi 11} 
somewhere in the column format so that all the subsequent inter-column spacings can 
stretch out to fill the predefined table width. 

If the left or right borders of the table do not consist of a vertical line, a spacing equal 
to half the normal inter-column spacing is added there. If this spacing is not required, it 
may be suppressed by including an empty ©-expression ©{} at the beginning or end of the 
column format. 


width 


cols 



xi. Floats 

Contain the actual entries in the table, each horizontal row being terminated 
with \\. These rows consist of a sequence of column entries separated from 
each other by the & symbol. Thus each row in the table contains the same 
number of column entries as in the column definition cols. Some entries may be 
empty. The individual column entries are treated by ffljXas though they were 
enclosed in braces { }, so that any change in type style or size are restricted to 
that one column. 

This command may only appear before the first row or immediately after a row 
termination \\. It draws a horizontal line the full width of the table below the 
row that was just ended, or at the top of the table if it comes at the beginning. 
Two \hline commands together draw two horizontal lines with a little space 
between them. 

\cl i ne{n - m] 

This command draws a horizontal line from the left side of column n to the 
right side of column m. Like \hline, it may only be given just after a row 
termination \\, and there may be more than one after another. The command 
\c1 ine{i- 3 } \cline{ 5 - 7 } draws two horizontal lines from column i to 3 and 
from column 5 to 7, below the row that was just ended. In each case, the full 
column widths are underlined. 

\vl i ne This command draws a vertical line with the height of the row at the location 
where it appears. In this way, vertical lines that do not extend the whole height 
of the table may be inserted with a column. 

\mul ti col umnjnumjjcol [{text} 

This command combines the following num columns into a single column with 
their total width including inter-column spacing. The argument col contains 
exactly one of the positioning symbols 1, r, c, with possible ©-expressions and 
vertical lines ". A value of 1 may be given for num when the positioning 
argument is to be changed for that column in one particular row. 

In this context, a ‘column’ starts with a positioning symbol 1 , r, or c and 
includes everything upto but excluding the next one. The first column also 
includes everything before the first positioning symbol. Thus c@{}rl " contains 
three columns: the first is "c@{}, the second r, and the third r". 

XI. 2. 2. Table style parameters 

There are a number of style parameters used in generating tables which LT£Xsets to stan- 
dard values. These may be altered by the user, either globally within the preamble or 
locally inside an environment. They should not be changed within the tabular environ- 
ment. 

• \tabcol sep is half the width of the spacing that is inserted between columns in the 
tabular and tabular* environments. 

• \arrayrul ewi dth is the thickness of the vertical and horizontal lines within a table. 

• \doublerulesep is the separation between the lines of a double rule. 

• \arraystretch can be used to change the distance between the rows of a table. 
This is a multiplying factor, with a standard value of 1. A value of 1 . 5 means that 
the inter-row spacing is increased by 50%. A new value is set by redefining the 
parameter with the command: 
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\renewcommand{\arraystrech}{/ac?or} 

Following are the commands for changing the table style parameters that relate to 
dimensions: 

\setl ength\tabcol sep {dimen} 

\setl ength\array rul ewi dth {dimen} 

\setl ength\doubl erul esep {dimen} 


XI. z. 3. Example 

Creating tables is much easier in practice than it would seem from the above list of 
formatting possibilities. This is best illustrated with an example. 

The simplest table consists of rows and columns in which the text entries are either 
centered or justified to one side. The column widths, the spacing between the columns, 
and thus the entire width of the table are automatically calculated. 


Sample Tabular 


col head 

col head 

col head 

Left 

centered 

right 

aligned 

items 

aligned 

items 

items 

items 

Left items 

centered 

right aligned 


See the code that generated the table above. 

\begi n{tabular{~\ I c | r | } 

\hl i ne 

\mul ti col umn{3{ | c | }{Sample Tabular } 

\hl i ne 

col head & col head & col head 
\hl i ne 

Left & centered & right \\\cl i ne{i-2} 

aligned & items & aligned \\\cl i ne{2-3} 

items & items & items \\\cl i ne{l-2} 

Left items & centered & right aligned 

\hl i ne 

\end {tabular} 

The discussion on tables doesn’t conclude with this chapter, instead more bells and 
whistles are to be discussed, such as long tables (tables that span multiple pages), how to 
repeat the column headings and special footlines in all multipaged tables, color tables and 
also a few other embellishments, which the scientific community at large might require 
in their document preparation. 


XI. 2. 4. Exercise 

Here is an exercise you can try. 
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xii. i. Why cross references? 

Cross reference is the technical term for quoting yourself. This is what you do when you 
say something like, “As I said earlier,. . More seriously, in a written article you may 
often have occasion to refer the reader to something mentioned earlier (or sometimes to 
something yet to be said) in the same document. Thus you may have explained a new 
term in the second section of your article and when you use this term again in the fourth 
section, it is a matter of courtesy to the reader to point to the explanation. Again, in 
a mathematics article, you may have to cite an earlier result in the proof of the current 
result. 

Such cross referencing can be done by hand, but if you revise your document and 
insert some new sections (or theorems) then changing all cross references manually is no 
easy task. It is always better to automate such tedious tasks. (After all what’s a computer 
for, if not to do such mundane jobs?) 

xii. 2. Let ETeX do it 

The basic method of using cross references (see Section xil.i for what we mean by cross 
reference) in ffl£X is quite simple. Suppose that somewhere in the second section of your 
article, you want to refer to the first section. You assign a key to the first section using 
the command 

\secti on {section name}\~\ abel {key} 

and at the point in the second section where the reference is to be made, you type the 
command 

\ref {key} 

Thus the reference “see Section xil.i. . . ” in the first sentence of this section was 
produced by including the command \1 abel {i ntro} in the command for the first section 
as 


\secti on{Why cross references}\l abel {i ntro} 

and the command \ref {intro} at the place of reference in the second section as 
...(see Section \ref {intro} for... 

Okay, the example is a bit silly, since the actual reference here is not really necessary, but 
you get the general idea, don’t you? Incidentally, the \label{&ey} for a section need not 
be given immediately after the \section{serfz'o/z name}. It can be given anywhere within 
the section. 
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The first time you run BTgX on a file named, say, myf i 1 e . tex containing cross refer- 
ences, the reference information is written in an auxiliary file named myfile.aux and at 
the end of the run MgX prints a warning 

LaTeX Warning: There were undefined references. 

LaTeX Warning: Label (s) may have changed. 

Rerun to get cross-references right. 

A second run gets the references right. The same thing happens when you’ve changed 
the reference information in any way, say, by adding a new section. 

Though the key in \1 abel {key} can be any sequence of letters, digits or punctuation 
characters, it is convenient to use some mnemonic (such as \label { limcon } for a section 
entitled “Limits and Continuity” rather than \label {sec@#’T/}. Also, when you make a 
reference, it’s better to type "\ref {limcon} (notice the tie}) than \ref {limcon} to prevent 
the possibility of the reference number falling off the edge as in “ . . . see Section xil.i for 
further details 

In addition to sectioning commands such as \chapter or \section, reference can 
also be made to an \item entry in an enumerate environment, by attaching a \label. For 
example the input 

In the classical \emph{syllogi sm} 

\begi nfenumerate} 

\item All men are mortal .\label{prel} 

\item Socrates is a man. \1 abel {pre2} 

\item So Socrates is a mortal .\label {con} 

\end{enumerate} 

Statements (\ref{prel}) and (\ref{pre2}) are the \emph{premi ses} and 
statement (\ref{con}) is the conclusion. 

gives the following output 


In the classical syllogism 

(1) All men are mortal. 

(2.) Socrates is a man. 

(3) So Socrates is a mortal. 

Statements (1) and (2) are the premises and statement (3) is the conclusion 


You must be a bit careful about references to tables or figures (technically, “floats”). 
For them, the \label command should be given after the \caption command or in its 
argument, as in the example below: 

\begi n{tabl e} [h] 

\begi n{center} 

\setl ength{\extrarowhei ght}{5pt} 

\begi n{tabul ar}{|c|c|c|c|} 

\hl i ne 

Value of $x$ & 1 & 2 & 3\\ 

\hl i ne 

Value of $y$ & 1 & 8 & 27\\ 

\hl i ne 

\end{tabul ar} 

\capti on{Observed values of $x$ and $y$}\l abel {tabxy} 
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\end{center} 

\end{tabl e} 

Two possible relations betweeen $x$ and $y$ satisfying 
the data in Tabl e\ref{tabxy} are $y=x“3$ and 
$y=6x“2-llx+6$ 

This produces the following output: 


Value of x 

I 

2 

3 

Value of y 

I 

8 

2-7 


Table XII. i: Observed values of x and y 


Two possible relations between x and y satisfying the data in Table XII. i 
are y = x 3 and y = 6 x 2 - llx + 6 

You can think of a \caption command within a figure or table environment as a 
sort of sectioning command within the environment. Thus you can have several \caption 
and \label pairs within a single figure or table environment. 

You can also make forivard references in exactly the same way by \ref-ing to the 
key of some succeeding \label such as “see Subsection xil. 2.1 for a discussion of cross 
references in mathematics.” 

XII. 2. 1. Cross references in math 

Mathematical documents abound in cross references. There are references to theorems 
and equations and figures and whatnot. The method of reference is exactly as before. 
Thus if you’ve defined \newtheorem{theorem} [subsection], then after typing 

\begi n{theorem}\label {di ffcon} 

Every differentiable function is continuous 
\end{theorem} 

you get 

Xll. 2 . 1.1 Theorem. Every differentiable function is continuous 

and you can type elsewhere in the document 
The converse of Theorem~\ref{di ffcon} is false, 
to get 

The converse of Theorem XII.2.1.1 is false. 


References can be made to equations as in the following examples: 

\begi n{equati on}\l abel {sumsq} 

(x+y) “2=x~2+2xy+y~2 
\end{equation} 

Changing $y$ to $-y$ in Equation"(\ref{sumsq}) gives the following 
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(XII. i) (x + y) 2 = x 2 + 2xy + y 2 

Changing y to —y in Equation (xil.i) gives the following 


If you load the package amsmath, you can use the command \eqref instead of \ref 
to make a reference to an equation. This automatically supplies the parantheses around 
the equation number and provides an italic correction before the closing parenthesis, if 
necessary. For example, 

Equation \eqref {sumsq} gives the following 

produces 


Equation XII. i gives the following 


References can be made to individual equations in multiline displays of equations 
produced by such environments as align or gather (defined in the amsmath package). 
The \label command can be used within such a structure for subnumbering as in the 
example below: 

\begi n{al i gn} 

(x+y) ~2&=x~2+2xy+y "2\1 abel {sum}\\ 

(x-y) ~2&=x“2-2xy+y“2\tag{\ref{sum}a} 

\end{al i gn} 


(XII. 2 ) 

(x + y) 2 = x 2 + 2xy + y 2 

(XII. 2 a) 

(x - yf = x 2 - 2 xy + y 2 


xii. 3. Pointing to a page— the package varioref 

In making a reference to a table or an equation, it is more to convenient (for the reader, 
that is) to give the page number of the reference also. The command 

\pageref {key} 

typesets the number of the page where the command \1 abel {key} was given. Thus for 
example 

see Table~\ref{tabxy} in page"\pageref{tabxy} 
in this document produces 

see Table Xil.i in page 137 

To avoid the tedium of repeated by typing 
\re.f{key} on page \pageref{£ey} 
you can define the macro 
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\newcommand{\full ref} [1] {\ref{#l} on page"\pageref{#l}} 

and use \fuTI ref for such references. But the trouble is that at times the referred object 
and the reference to it fall on the same page (with TpX you never know this till the end) 
so that you get a reference to the page number of the very page you are reading, which 
looks funny. This can be avoided by using the package varioref. If you load this package 
by including \usepackage{varioref} in your preamble, then you can use the command 

\vref {key} 

to refer to an object you’ve marked with \1 abel {key} elsewhere in the document. The ac- 
tion of \vref varies according to the page(s) where the referred object and the references 
are typeset by TpX in the final output. 

(1) If the object and the reference are on the same page, \vref produces only a \ref sup- 
pressing \pageref so that only the number pointing to the object is typeset, without 
any reference to the page number. 

(2) If the object and the reference are on different pages whose numbers differ by more 
than one, \vref produces both \ref and \pageref. 

(3) If the object and the reference fall on pages whose numbers differ by one (that is, 
on successive pages), \vref produces \ref followed by the phrase “on the preceding 
page” or “on the following page” depending on whether the object or the reference 
occurs first. Moreover, in the next occurrence of \vref in a situation of the same type, 
the phrases are changed to “on the next page” and the “page before” respectively. 

This is the default behavior of \vref in the article documentclass. If the article class is 
used with the twoside option or if the documentclass book is used, then the behavior in 
Case (3) above is a bit different. 

(1) If the object and the reference fall on the two sides of the same leaf, the behavior of 
\vref is as in (3) above. 

(2) If the object and the reference fall on pages forming a double spread (that is, a page 
of even number followed by the next page), then \vref produces \ref followed by the 
phrase “on the facing page”. Moreover, in the next occurence of \vref in a situation 
of the same type, the phrases are changed to “on the preceding page” and “on the 
next page” respectively. 

The phrases used in the various cases considered above can be customized by redefining 
the commands used in generating them. For the article class without the twoside option, 
reference to the previous page uses the command \reftextbefore and reference to the 
next page uses \reftextafter. In the case of the article class with the twoside option or 
the book class, the commands \reftextfaceafter and \reftextfacebefore are used in the 
case of reference to a page in a double spread. The default definitions of these commands 
are given below. In all these, the two arguments of the command \reftextvario are 
phrases alternatively used in the repeated use of the reference as mentioned above. 

\newcommand{\reftextbefore} 

{on the \reftextvario{preceding page}{page before}} 
\newcommand{\reftextafter} 

{on the \reftextvario{foTlowi ng}{next} page} 
\newcommand{\reftextfacebefore} 

{on the \reftextvario{faci ng}{precedi ng} page} 
\newcommand{\reftextfaceafter} 

{on the \reftextvario{facing}{next}{page}} 
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You can customize the phrases generated in various situations by redefining these 
with phrases of your choice in the arguments of \reftextvario. 

If you want to refer only to a page number using \varioref, you can use the com- 
mand 

\vpageref {key} 

to produce the page number of the object marked with \label{feey}. The phrases 
used in the various special cases are the same as described above, except that when 
the referred object and the reference fall on the same page, either the phrase “on this 
page” or “on the current page” is produced. The command used to generate these is 
\reftextcurrent whose default definition is 

\newcommand{\reftextcurrent} 

{on \reftextvario{this}{the current} page} 

You can change the phrases “this” and “the current” globally by redefining this com- 
mand. You can also make some local changes by using the two optional arguments that 
\vpageref allows. Thus you can use the command 

\vpage ref [same page phrase ] [ other page phrase ] {key} 

to refer to the page number of the object marked with \labe! {&ey}. The same page 
phrase will be used if the object and the reference fall on the same page and the phrase 
other page phrase will be used, if they fall on different pages. Thus for example, the 
command 

see the \vpageref [above tabl e] [tabl e] {tabxy} 
given in this document will produce 


see the above table 

if the reference occurs on the same page as Table Xll.i and 


see the table on page 137 
if they fall on different pages. 

xii.4. Pointing outside— the package xr 

Sometimes you may want to refer to something in a document other than the one you 
are working on. (This happens, for instance if you keep an article as separate files.) The 
package xr allows such external references. 

If you want to refer to objects in a file named other.tex in your current document, 
load the package xr and set the external document as other.tex using the commands 

\usepackage{xr} \externaldocument{ot^er} 

in the preamble of the current document. Then you can use the \ref and \pageref to 
refer to anything that has been marked with the \label command in either the current 
document or other.tex. Any number of such external documents can be specified. 

If the same key is used to mark different objects in two such documents, there’ll be a 
conflict. To get over this, you can use the optional argument available in \external document 
command. If you say 

\external document [a-} {other} 

then a reference to \labe1{&ey} in other.tex could be made by \ref {a-key}. The prefix 
need not be a-; it can be any convenient string. 




XII. J . LOSTTHEKEYSpUSElablst.tex 
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xii. 5. Lost the keys? Use iabist.tex 

One of the conveniences of using keys for cross references is that you need not keep track 
of the actual numbers, but then you’ll have to remember the keys. You can produce the 
list of keys used in a document by running KTgX on the file lablst.tex. In our system, 
we do this by first typing 

latex lab! st 

ETeX responds as follows: 

********************************* 

* Enter input file name 

* without the .tex extension: 

* * * * * * * * * * * * * * * * * * * * * * * * ********* 


\lablstfile= 

We type in the file name as cref which is the source of this document and is presented 
with another query. 

********************************************** 

* Enter document class used in file cref.tex 

* with no options or extension: 

* * * * * * * * * * * * * * * * * * * * ************************** 


\1 abl stcl ass= 

So we type article. And is asked 


* Enter packages used in file cref.tex 

* with no options or extensions: 

******************************************** 


\1 abl stpackages= 

Here only those packages used in the article which define commands used in section 
titles etc. need be given. So we type 

amsmath , array , enumerate 

This produces a file lablst.dvi which can be viewed to see a list of keys used in the 
document. 

Finally if your text editor is GNU Emacs, then you can use its RefTeX package to auto- 
mate generation, insertion and location of keys at the editing stage. 
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FOOTNOTES, MARGINPARS, AND ENDNOTES 


LTpX has facilities to typeset “inserted” text, such as footnotes, marginal notes, figures 
and tables. This chapter looks more closely at different kinds of notes. 

xm. i. Footnotes 

Footnotes are generated with the command 
\footnot e{ footnote Jext} 

which comes immediately after the word requiring an explanation in a footnote. The 
text footnote_text appears as a footnote in a smaller typeface at the bottom of the page. 
The first line of the footnote is indented and is given the same footnote marker as that 
inserted in the main text. The first footnote on a page is separated from the rest of the 
page text by means of a short horizontal line. 

The standard footnote marker is a small, raised number 1 2 , which is sequentially num- 
bered. 

Footnotes produced with the \footnote command inside a minipage environment 
use the mpfootnote counter and are typeset at the bottom of the parbox produced by the 
minipage 1 . 

Flowever, if you use the \footnotemark command in a mini page it will produce a 
footnote mark in the same style and sequence as the main text footnotes — i.e., stepping 
the mpfootnote counter and using the \thefootnote command for the representation. 
This behavior allows you to produce a footnote inside your mi ni page that is typeset in se- 
quence with the main text footnotes at the bottom of the page: you place a \footnotemark 
inside the mi ni page and the corresponding \footnotetext after it. See below: 

\begi n{mi ni page} {5cm} 

Footnotes in a mini page are numbered 
using lowercase letters. \footnote{% 
Inside mini page} \par This text 
references a footnote at the bottom 
of the page.\footnotemark 
\end{mi ni page} 

\footnotetext{At bottom of page} 

The footnote numbering is incremented throughout the document for the article 
class, where it is reset to i for each new chapter in the report and book classes. 

r See how the footnote is produced: “ ... raised number \footnote(See how the footnote is produced: 

••• >• 

2 With nested minipages, the footnote comes after the next \endmi ni page command, which could be at the 
wrong place. 

3 At bottom of page. 


Footnotes in a minipage are num- 
bered using lowercase letters/ 

This text references a footnote at 
the bottom of the page . 3 

^Inside minipage 
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XIII. i. i. Footnotes in tabular material 

Footnotes appearing inside tabular material are not typeset by standard FTeX. Only 
tabularx and longtable environments will treat footnotes correctly. But footnotes used 
in these tables won’t appear just following the tables, but would appear at the bottom 
of the page just like the footnotes used in the text. But in longtable you can place the 
footnotes as table notes by placing the longtable in a minipage. See below: 


Table XIII.i 

PostScript type i fonts 

Courier' 1 

cour, courb, courbi, couri 

Nimbus 6 

unmr, unmrs 

URW Antiqua 6 

uaqrrc 

URW Grotesk 6 

ugqp 

Utopia 11 

putb, putbi, putr, putri 

^Donated by IBM. 

^Donated by URW GmbH. 

c Donated by Adobe. 


\begi n{mi ni page}{ . 47\textwidth} 
\renewcommand{\thefootnote}{\thempfootnote} 

\begi n{longtabl e}{ll } 

\caption{PostScri pt type 1 fonts}\\ 

Courier\footnote{Donated by IBM.} & cour,courb,courbi ,couri \\ 
Nimbus\footnote{Donated by URW GmbH.} & unmr, unmrs \\ 

URW Antiqua\footnotemark[\value{mpfootnote}] & uaqrrc\\ 

URW Grotesk\footnotemark[\value{mpfootnote}] & ugqp\\ 

Utopi a\footnote{Donated by Adobe.} & putb, putbi, putr, putri 
\end{longtable} 

\end{mi ni page} 


You can also put your tabular or array environment inside a minipage environ- 
ment, since in that case footnotes are typeset just following that environment. Note the 
redefinition of \thefootnote that allows us to make use of the \footnotemark command 
inside the minipage environment. Without this redefinition \footnotemark would have 
generated a footnote mark in the style of the footnotes for the main page. 

\begi n{mi ni page}{ . 5\1 i newi dth} 

\renewcommand{\thefootnote}{\thempfootnote} 

\begi n{tabul ar}{ll } 

\mul ti col umn{2}{c}{\bfseri es PostScript type 1 fonts} \\ 

Couri er\footnote{Donated by IBM.} & cour,courb,courbi ,couri \\ 
Charter\footnote{Donated by Bitstream.} & bchb,bchbi ,bchr,bchri\\ 
Nimbus\footnote{Donated by URW GmbH.} & unmr, unmrs \\ 

URW Antiqua\footnotemark[\value{mpfootnote}] & uaqrrc\\ 

URW Grotesk\footnotemark[\value{mpfootnote}] & ugqp\\ 

Utopi a\footnote{Donated by Adobe.} & putb, putbi, putr, putri 
\end{tabul ar} 

\end{mi ni page} 
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PostScript type 1 fonts 


Courier" 

Charter^ 

Nimbus" 

URW Antiqua" 
URW Grotesk" 
Utopia^ 


cour, courb, courbi, couri 
bchb, bchbi, bchr, bchri 
unmr, unmrs 
uaqrrc 

ugqp 

putb, putbi, putr, putri 


"Donated by IBM. 
^Donated by Bitstream. 
"Donated by URW GmbH. 
“^Donated by Adobe. 


Of course this approach does not automatically limit the width of the footnotes to 
the width of the table, so a little iteration with the mini page width argument might be 
necessary. 

Another way to typeset table notes is with the package threeparttable by Donald 
Arseneau. This package has the advantage that it indicates unambiguously that you are 
dealing with notes inside tables and, moreover, it gives you full control of the actual refer- 
ence marks and offers the possibility of having a caption for our tabular material. In this 
sense, the threeparttable environment is similar to the nonfloating table environment. 

\begi n{threeparttabl e} 

\caption{\textbf {PostScri pt type 1 fonts}} 

\begi n{tabul ar}{ll } 

Couri er\tnote{a} & cour, courb, courbi, couri\\ 

Charter\tnote{b} & bchb, bchbi, bchr, bchri \\ 

Nimbus\tnote{c} & unmr, unmrs \\ 

URW Anti qua\tnote{c} & uaqrrc\\ 

URW Grotesk\tnote{c} & ugqp\\ 

Utopi a\tnote{d} & putb, putbi, putr, putri 
\end{tabul ar} 

\begi n{tablenotes} 

\item[a] Donated by IBM. 

\item[b] Donated by Bitstream. 

\item[c] Donated by URW GmbH. 

\item[d] Donated by Adobe. 

\end{tabl enotes} 

\end{threeparttabl e} 


Table 14.2: PostScript type 1 fonts 
Courier 3 cour, courb, courbi, couri 

Charter 11 bchb, bchbi, bchr, bchri 

Nimbus" unmr, unmrs 

URW Antiqua" uaqrrc 

URW Grotesk" ugqp 

Utopia " 1 putb, putbi, putr, putri 

a Donated by IBM. 
b Donated by Bitstream. 
c Donated by URW GmbH. 
d Donated by Adobe. 
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XIII. 1. 2. Customizing footnotes 

If the user wishes the footnote numbering to be reset to 1 for each \section command 
with the article class, this may be achieved by putting 

\setcounter{footnote}{0} 

before every section or using the following command at preamble 4 
\@addto reset {footnote} {section} 

The internal footnote counter has the name footnote. Each call to \footnote increments 
this counter by one and prints the new value in Arabic numbering as the footnote marker. 
A different style of marker can be implemented with the command 

\renewcommand{\thefootnote}{ttM»;£>er_sf;y/e} {footnote} 

where number style is one of the counter print commands; \arabic, \roman, \Roman, 
\alph, or \Alph. However, for the counter footnote, there is an additional counter print 
command available, \fnsymbol, which prints the counter values 1-9 as one of nine sym- 
bols: 

★ + t § 1 II ★ ★ ++ tt 

It is up to the user to see that the footnote counter is reset to zero sometime before 
the tenth \footnote call is made. If the user wants to add values above nine, then he 
has to edit the definition of \fn symbol. See an example, which allows up to 12 footnotes 
without resetting the counter: 

\makeatl etter 

\def\@fnsymbol#l{\ensuremath{\ifcase#l\or *\or \dagger\or \ddagger\or 
\mathsecti on\or \mathparagraph\or \|\or **\or \dagger\dagger 
\or \ddagger\ddagger\or \mathsection\mathsection 
\or \mathparagraph\mathparagraph \or \ | \ | \el se\@ctrerr\fi }} 
\renewcommand{\thefootnote}{\fnsymbol {footnote}} 

\makeatother 

An optional argument may be added to the \footnote command: 

\footnote \num\ {footnote .text} 

where num is a positive integer that is used instead of the value of the footnote counter 
for the marker. In this case, the footnote counter is not incremented. For example**, 

\renewcommand{\thefootnote}{\fnsymbol {footnote}} 

For example\footnote [7] {The 7$~{\rm th}$ symbol .... marker.}, 
\renewcommand{\thefootnote}{\arabi c{footnote}} 

where the last line is necessary to restore the footnote marker style to its standard form. 
Otherwise, all future footnotes would be marked with symbols and not with numbers. 

XIII. 1. 3. Footnote style parameters 

The appearance of the standard footnote can be changed by customizing the parameters 
listed below: 

\footnotesi ze The font size used inside footnotes. 

4 This command will only work within \makeat letter and \makeatother. 

**The 7 th symbol appears as the footnote marker. 
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The height of a strut placed at the beginning of every footnote. If it is 
greater than the \base1ineskip used for \footnotesize, then additional 
vertical space will be inserted above each footnote. 

A low-level TpX command that defines the space between the main text 
and the start of the footnotes. You can change its value with the \setl ength 
or \addtol ength commands by putting \ski p\footi ns into the first argu- 
ment, e.g., 

\addtol ength{\ski p\footi ns}{3mm} 

\footnoterule A macro to draw the rule separating footnotes from the main text. It is 
executed right after the vertical space of \skip\footins. It should take 
zero vertical space, i.e., it should use a negative skip to compensate for 
any positive space it occupies, for example: 

\renewcommand{\footnoterul e{\vspace*{-3pt}% 

\rul e{ . 4\col umnwi dth}{0 . 4pt}\vspace*{2 . 6pt} 

You can also construct a fancier “rule” e.g., one consisting of a series of dots: 

\renewcommand{\footnoterul e}{\vspace*{-3pt}% 

\qquad\dotfi I l\qquad\vspace*{2 . 6pt}} 

xiii. 2 .. Marginal notes 

\marginpar{ left-text } { right-text } 

The \marginpar command generates a marginal note. This command typesets the text 
given as an argument in the margin, the first line at the same height as the line in the 
main text where the \marginpar command occurs. The marginal note appearing here 
was generated with 

... command occurs\margi npar{Thi s is a marginal note}. The ... 

When only the mandatory argument right-text is specified, then the text goes to the right 
margin for one-sided printing; to the outside margin for two-sided printing; and to the 
nearest margin for two-column formatting. When you specify an optional argument, it 
is used for the left margin, while the second (mandatory) argument is used for the right. 

There are a few important things to understand when using marginal notes. First, 
\marginpar command does not start a paragraph, that is, if it is used before the first 
word of a paragraph, the vertical alignment may not match the beginning of the para- 
graph. Secondly, if the margin is narrow, and the words are long (as in German), you 
may have to precede the first word by a \hspace{Opt} command to allow hyphenation 
of the first word. These two potential problems can be eased by defining a command 
\marginlabel{text}, which starts with an empty box \mbox{}, typesets a marginal note 
ragged left, and adds a \hspace{Opt} in front of the argument. 

\newcommand{\margi nl abel } [1] 

{\mbox{}\margi npar{\raggedl eft\hspace{Opt}#l}} 

By default, in one-sided printing the marginal notes go on the outside margin. These 
defaults can be changed by the following declarations: 

\reversemargi npar Marginal notes go into the opposite margin with respect to the de- 
fault one. 

\normalmargi npar Marginal notes go into the default margin. 


\footnotesep 


\ski p\footi ns 


This 
is a 

margi- 

nal 

note 
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Hey! 

Look 


XIII. 2.1. Uses of marginal notes 

\marginpar{} can be used to draw attention to certain text passages by marking them 
with a vertical bar in the margin. The example marking this paragraph was made by 
including 

\margi npar{\rule [-10. 5mm] {1mm} {10mm}} 
in the first line. By defining a macro \query as shown below 
\def\query#l#2{\underl i ne{#l}\margi npar{#2}} 

we can produce queries. For example DTeX. This query is produced with the following 
command. 


For example \query{\LaTeX}{Hey !\\ Look}{}. This ... 


XIII. 2. 2. Style parameters for marginal notes 

The following style parameters may be changed to redefine how marginal notes appear: 

\margi nparwi dth Determines the width of the margin box. 

\margi nparsep Sets the separation between the margin box and the edge of the main 
text. 

\margi nparpush Is the smallest vertical distance between two marginal notes. 

These parameters are all lengths and are assigned new values as usual with the 
\setlength command. 


xiii. 3. Endnotes 

Scholarly works usually group notes at the end of each chapter or at the end of the 
document. These are called endnotes. Endnotes are not supported in standard DTeX, but 
they can be created in several ways. 

The package endnotes (by John Lavagnino) typesets endnotes in a way similar to 
footnotes. It uses an extra external file, with extension .ent, to hold the text of the 
endnotes. This file can be deleted after the run since a new version is generated each 
time. 

With this package you can output your footnotes as endnotes by simply giving the 
command: 

\renewcommand{\footnote}{\endnote} 

The user interface for endnotes is very similar to the one for footnotes after sub- 
stituting the word “foot” for “end”. The following example shows the principle of the 
use of endnotes, where you save text in memory with the \endnote command, and then 
typeset all accumulated text material at a point in the document controlled by the user. 


This is simple text.\endnote{The first 
endnote.} This is simple text.\endnote{% 
The second endnote.} This is simple 
text.\endnote{The third endnote.} 

\theendnotes\bi gski p 

This is some more simple text 


This is simple text . 1 This is simple 
text . 2 This is simple text . 3 

Notes 

1 The first endnote. 

-The second endnote. 

3 The third endnote. 

This is some more simple text 


GNU FREE DOCUMENTATION LICENSE 


Version 1.2, November 2002 

Copyright © 2000,2001,2002 Free Software Foundation, Inc. 59 Temple 
Place, Suite 330, Boston, MA 02111-1307, USA 

Everyone is permitted to copy and distribute verbatim copies of this license 
document, but changing it is not allowed. 


o PREAMBLE 

The purpose of this License is to make a manual, textbook, or other functional and 
useful document free in the sense of freedom: to assure everyone the effective freedom 
to copy and redistribute it, with or without modifying it, either commercially or non- 
commercially. Secondarily, this License preserves for the author and publisher a way 
to get credit for their work, while not being considered responsible for modifications 
made by others. 

This License is a kind of “copyleft”, which means that derivative works of the doc- 
ument must themselves be free in the same sense. It complements the GNU General 
Public License, which is a copyleft license designed for free software. 

We have designed this License in order to use it for manuals for free software, because 
free software needs free documentation: a free program should come with manuals 
providing the same freedoms that the software does. But this License is not limited to 
software manuals; it can be used for any textual work, regardless of subject matter or 
whether it is published as a printed book. We recommend this License principally for 
works whose purpose is instruction or reference. 

(1) APPLICABILITY AND DEFINITIONS 

This License applies to any manual or other work, in any medium, that contains a 
notice placed by the copyright holder saying it can be distributed under the terms 
of this License. Such a notice grants a world-wide, royalty-free license, unlimited 
in duration, to use that work under the conditions stated herein. The “Document”, 
below, refers to any such manual or work. Any member of the public is a licensee, 
and is addressed as “you”. You accept the license if you copy, modify or distribute 
the work in a way requiring permission under copyright law. 

A “Modified Version” of the Document means any work containing the Document or 
a portion of it, either copied verbatim, or with modifications and/or translated into 
another language. 
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A “Secondary Section” is a named appendix or a front-matter section of the Doc- 
ument that deals exclusively with the relationship of the publishers or authors of 
the Document to the Document’s overall subject (or to related matters) and contains 
nothing that could fall directly within that overall subject. (Thus, if the Document is 
in part a textbook of mathematics, a Secondary Section may not explain any mathe- 
matics.) The relationship could be a matter of historical connection with the subject 
or with related matters, or of legal, commercial, philosophical, ethical or political 
position regarding them. 

The “Invariant Sections” are certain Secondary Sections whose titles are designated, 
as being those of Invariant Sections, in the notice that says that the Document is 
released under this License. If a section does not fit the above definition of Secondary 
then it is not allowed to be designated as Invariant. The Document may contain zero 
Invariant Sections. If the Document does not identify any Invariant Sections then 
there are none. 

The “Cover Texts” are certain short passages of text that are listed, as Front-Cover 
Texts or Back-Cover Texts, in the notice that says that the Document is released under 
this License. A Front-Cover Text may be at most 5 words, and a Back-Cover Text 
may be at most 25 words. 

A “Transparent” copy of the Document means a machine-readable copy, represented 
in a format whose specification is available to the general public, that is suitable 
for revising the document straightforwardly with generic text editors or (for images 
composed of pixels) generic paint programs or (for drawings) some widely available 
drawing editor, and that is suitable for input to text formatters or for automatic trans- 
lation to a variety of formats suitable for input to text formatters. A copy made in 
an otherwise Transparent file format whose markup, or absence of markup, has been 
arranged to thwart or discourage subsequent modification by readers is not Transpar- 
ent. An image format is not Transparent if used for any substantial amount of text. 
A copy that is not “Transparent” is called “Opaque”. 

Examples of suitable formats for Transparent copies include plain ASCII without 
markup, Texinfo input format, L'TpX input format, SGML or XML using a publicly 
available DTD, and standard-conforming simple HTML, PostScript or PDF designed 
for human modification. Examples of transparent image formats include PNG, XCF 
and JPG. Opaque formats include proprietary formats that can be read and edited 
only by proprietary word processors, SGML or XML for which the DTD and/or pro- 
cessing tools are not generally available, and the machine-generated HTML, PostScript 
or PDF produced by some word processors for output purposes only. 

The “Title Page” means, for a printed book, the title page itself, plus such following 
pages as are needed to hold, legibly, the material this License requires to appear in the 
title page. For works in formats which do not have any title page as such, “Title Page” 
means the text near the most prominent appearance of the work’s title, preceding the 
beginning of the body of the text. 

A section “Entitled XYZ” means a named subunit of the Document whose title either 
is precisely XYZ or contains XYZ in parentheses following text that translates XYZ 
in another language. (Here XYZ stands for a specific section name mentioned below, 
such as “Acknowledgements”, “Dedications”, “Endorsements”, or “History”.) To 
“Preserve the Title” of such a section when you modify the Document means that it 
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remains a section “Entitled XYZ” according to this definition. 

The Document may include Warranty Disclaimers next to the notice which states that 
this License applies to the Document. These Warranty Disclaimers are considered to 
be included by reference in this License, but only as regards disclaiming warranties: 
any other implication that these Warranty Disclaimers may have is void and has no 
effect on the meaning of this License. 

(2) VERBATIM COPYING 

You may copy and distribute the Document in any medium, either commercially or 
noncommercially, provided that this License, the copyright notices, and the license 
notice saying this License applies to the Document are reproduced in all copies, and 
that you add no other conditions whatsoever to those of this License. You may not 
use technical measures to obstruct or control the reading or further copying of the 
copies you make or distribute. However, you may accept compensation in exchange 
for copies. If you distribute a large enough number of copies you must also follow 
the conditions in section 3. 

You may also lend copies, under the same conditions stated above, and you may 
publicly display copies. 

(3) COPYING IN QUANTITY 

If you publish printed copies (or copies in media that commonly have printed cov- 
ers) of the Document, numbering more than 100, and the Document’s license notice 
requires Cover Texts, you must enclose the copies in covers that carry, clearly and 
legibly, all these Cover Texts: Lront-Cover Texts on the front cover, and Back-Cover 
Texts on the back cover. Both covers must also clearly and legibly identify you as the 
publisher of these copies. The front cover must present the full title with all words 
of the title equally prominent and visible. You may add other material on the covers 
in addition. Copying with changes limited to the covers, as long as they preserve the 
title of the Document and satisfy these conditions, can be treated as verbatim copying 
in other respects. 

If the required texts for either cover are too voluminous to fit legibly, you should put 
the first ones listed (as many as fit reasonably) on the actual cover, and continue the 
rest onto adjacent pages. 

If you publish or distribute Opaque copies of the Document numbering more than 
100, you must either include a machine-readable Transparent copy along with each 
Opaque copy, or state in or with each Opaque copy a computer-network location 
from which the general network-using public has access to download using public- 
standard network protocols a complete Transparent copy of the Document, free of 
added material. If you use the latter option, you must take reasonably prudent steps, 
when you begin distribution of Opaque copies in quantity, to ensure that this Trans- 
parent copy will remain thus accessible at the stated location until at least one year 
after the last time you distribute an Opaque copy (directly or through your agents or 
retailers) of that edition to the public. 

It is requested, but not required, that you contact the authors of the Document well 
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before redistributing any large number of copies, to give them a chance to provide 
you with an updated version of the Document. 

(4) MODIFICATIONS 

You may copy and distribute a Modified Version of the Document under the condi- 
tions of sections 2 and 3 above, provided that you release the Modified Version under 
precisely this License, with the Modified Version filling the role of the Document, thus 
licensing distribution and modification of the Modified Version to whoever possesses 
a copy of it. In addition, you must do these things in the Modified Version: 

(A) Use in the Title Page (and on the covers, if any) a title distinct from that of the 
Document, and from those of previous versions (which should, if there were any, 
be listed in the History section of the Document). You may use the same title as a 
previous version if the original publisher of that version gives permission. 

(B) List on the Title Page, as authors, one or more persons or entities responsible for 
authorship of the modifications in the Modified Version, together with at least 
five of the principal authors of the Document (all of its principal authors, if it has 
fewer than five), unless they release you from this requirement. 

(C) State on the Title page the name of the publisher of the Modified Version, as the 
publisher. 

(D) Preserve all the copyright notices of the Document. 

(E) Add an appropriate copyright notice for your modifications adjacent to the other 
copyright notices. 

(F) Include, immediately after the copyright notices, a license notice giving the public 
permission to use the Modified Version under the terms of this License, in the form 
shown in the Addendum below. 

(G) Preserve in that license notice the full lists of Invariant Sections and required Cover 
Texts given in the Document’s license notice. 

(H) Include an unaltered copy of this License. 

(I) Preserve the section Entitled “History”, Preserve its Title, and add to it an item 
stating at least the title, year, new authors, and publisher of the Modified Version 
as given on the Title Page. If there is no section Entitled “History” in the Docu- 
ment, create one stating the title, year, authors, and publisher of the Document as 
given on its Title Page, then add an item describing the Modified Version as stated 
in the previous sentence. 

(J) Preserve the network location, if any, given in the Document for public access to 
a Transparent copy of the Document, and likewise the network locations given 
in the Document for previous versions it was based on. These may be placed 
in the “History” section. You may omit a network location for a work that was 
published at least four years before the Document itself, or if the original publisher 
of the version it refers to gives permission. 

(K) For any section Entitled “Acknowledgements” or “Dedications”, Preserve the Ti- 
tle of the section, and preserve in the section all the substance and tone of each of 
the contributor acknowledgements and/or dedications given therein. 

(L) Preserve all the Invariant Sections of the Document, unaltered in their text and 
in their titles. Section numbers or the equivalent are not considered part of the 
section titles. 

(M) Delete any section Entitled “Endorsements”. Such a section may not be included 
in the Modified Version. 

(N) Do not retitle any existing section to be Entitled “Endorsements” or to conflict in 
title with any Invariant Section. 
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(O) Preserve any Warranty Disclaimers. 


If the Modified Version includes new front-matter sections or appendices that qualify 
as Secondary Sections and contain no material copied from the Document, you may 
at your option designate some or all of these sections as invariant. To do this, add 
their titles to the list of Invariant Sections in the Modified Version’s license notice. 
These titles must be distinct from any other section titles. 

You may add a section Entitled “Endorsements”, provided it contains nothing but en- 
dorsements of your Modified Version by various parties — for example, statements of 
peer review or that the text has been approved by an organization as the authoritative 
definition of a standard. 

You may add a passage of up to five words as a Front-Cover Text, and a passage of up 
to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified 
Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be 
added by (or through arrangements made by) any one entity. If the Document already 
includes a cover text for the same cover, previously added by you or by arrangement 
made by the same entity you are acting on behalf of, you may not add another; but 
you may replace the old one, on explicit permission from the previous publisher that 
added the old one. 

The author(s) and publisher(s) of the Document do not by this License give permission 
to use their names for publicity for or to assert or imply endorsement of any Modified 
Version. 

(5) COMBINING DOCUMENTS 

You may combine the Document with other documents released under this License, 
under the terms defined in section 4 above for modified versions, provided that you 
include in the combination all of the Invariant Sections of all of the original docu- 
ments, unmodified, and list them all as Invariant Sections of your combined work in 
its license notice, and that you preserve all their Warranty Disclaimers. 

The combined work need only contain one copy of this License, and multiple identical 
Invariant Sections may be replaced with a single copy. If there are multiple Invariant 
Sections with the same name but different contents, make the title of each such sec- 
tion unique by adding at the end of it, in parentheses, the name of the original author 
or publisher of that section if known, or else a unique number. Make the same ad- 
justment to the section titles in the list of Invariant Sections in the license notice of 
the combined work. 

In the combination, you must combine any sections Entitled “History” in the various 
original documents, forming one section Entitled “History”; likewise combine any 
sections Entitled “Acknowledgements”, and any sections Entitled “Dedications”. You 
must delete all sections Entitled “Endorsements.” 

(6) COLLECTIONS OF DOCUMENTS 

You may make a collection consisting of the Document and other documents released 
under this License, and replace the individual copies of this License in the various 
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documents with a single copy that is included in the collection, provided that you 
follow the rules of this License for verbatim copying of each of the documents in all 
other respects. 

You may extract a single document from such a collection, and distribute it individu- 
ally under this License, provided you insert a copy of this License into the extracted 
document, and follow this License in all other respects regarding verbatim copying of 
that document. 

(7) AGGREGATION WITH INDEPENDENT WORKS 

A compilation of the Document or its derivatives with other separate and independent 
documents or works, in or on a volume of a storage or distribution medium, is called 
an “aggregate” if the copyright resulting from the compilation is not used to limit 
the legal rights of the compilation’s users beyond what the individual works permit. 
When the Document is included an aggregate, this License does not apply to the other 
works in the aggregate which are not themselves derivative works of the Document. 

If the Cover Text requirement of section 3 is applicable to these copies of the Doc- 
ument, then if the Document is less than one half of the entire aggregate, the Docu- 
ment’s Cover Texts may be placed on covers that bracket the Document within the 
aggregate, or the electronic equivalent of covers if the Document is in electronic form. 
Otherwise they must appear on printed covers that bracket the whole aggregate. 

(8) TRANSLATION 

Translation is considered a kind of modification, so you may distribute translations of 
the Document under the terms of section 4. Replacing Invariant Sections with trans- 
lations requires special permission from their copyright holders, but you may include 
translations of some or all Invariant Sections in addition to the original versions of 
these Invariant Sections. You may include a translation of this License, and all the 
license notices in the Document, and any Warrany Disclaimers, provided that you 
also include the original English version of this License and the original versions of 
those notices and disclaimers. In case of a disagreement between the translation and 
the original version of this License or a notice or disclaimer, the original version will 
prevail. 

If a section in the Document is Entitled “Acknowledgements”, “Dedications”, or 
“History”, the requirement (section 4) to Preserve its Title (section 1) will typically 
require changing the actual title. 

(9) TERMINATION 

You may not copy, modify, sublicense, or distribute the Document except as expressly 
provided for under this License. Any other attempt to copy, modify, sublicense or 
distribute the Document is void, and will automatically terminate your rights under 
this License. However, parties who have received copies, or rights, from you under 
this License will not have their licenses terminated so long as such parties remain in 
full compliance. 
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( 10 ) FUTURE REVISIONS OF THIS LICENSE 

The Free Software Foundation may publish new, revised versions of the GNU Free 
Documentation License from time to time. Such new versions will be similar in spirit 
to the present version, but may differ in detail to address new problems or concerns. 
See http: //www.gnu .org/copyleft/. 

Each version of the License is given a distinguishing version number. If the Document 
specifies that a particular numbered version of this License “or any later version” 
applies to it, you have the option of following the terms and conditions either of that 
specified version or of any later version that has been published (not as a draft) by 
the Free Software Foundation. If the Document does not specify a version number of 
this License, you may choose any version ever published (not as a draft) by the Free 
Software Foundation. 

ADDENDUM: How to use this License for your documents 

To use this License in a document you have written, include a copy of the License in the 
document and put the following copyright and license notices just after the title page: 

Copyright (C) year your name. Permission is granted to copy, distribute 
and/or modify this document under the terms of the GNU Lree Documenta- 
tion License, Version i.z or any later version published by the Lree Software 
Loundation; with no Invariant Sections, no Lront-Cover Texts, and no Back- 
Cover Texts. A copy of the license is included in the section entitled “GNU 
Lree Documentation License”. 

If you have Invariant Sections, Lront-Cover Texts and Back-Cover Texts, replace the 
“with. . . Texts.” line with this: 

with the Invariant Sections being list their titles, with the Lront-Cover 
Texts being 1 i st, and with the Back-Cover Texts being 1 i st. 

If you have Invariant Sections without Cover Texts, or some other combination of 
the three, merge those two alternatives to suit the situation. 

If your document contains nontrivial examples of program code, we recommend 
releasing these examples in parallel under your choice of free software license, such as 
the GNU General Public License, to permit their use in free software. 


